# awanish-26/folio architecture

> Architecture diagram of the GitHub repository awanish-26/folio, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-11-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/awanish-26/folio
- Repository: https://github.com/awanish-26/folio

## Overview

##### Project Type and Purpose
- This is a single-page frontend web application (a React SPA) bootstrapped with Vite (formerly Create React App) and styled with Tailwind CSS. There is no separate backend—static assets and compiled code are served by a CDN or static web host. Its purpose is likely a personal portfolio or landing site, given the presence of resume PDF, intro, projects, contact form, etc.

##### File-Structure Analysis
- Top-Level Files
- index.html – entry HTML template
- package.json / package-lock.json – npm scripts, dependencies, dev tools
- tailwind.config.js & vite.config.mjs – styling and bundler configuration
- public/
- manifest.json, robots.txt – PWA & SEO settings
- src/
- main.jsx & reportWebVitals.jsx – app bootstrap and performance hooks
- index.css – global styles (Tailwind imports)
- App.jsx – root React component
- Components/ – UI components (Sidebar, intro, projects, contact form, language selector)

##### Insights from README
- Standard React development lifecycle (npm start, build, test, eject)
- Build output lands in “build” folder for production
- No custom API layer mentioned—purely client-side routing and rendering

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Development Phase
    subgraph "Development Phase"
        Editor["Code Editor / IDE"]:::devtools
        NodeNpm["Node.js & npm"]:::devtools
        Vite["Vite Build Tool"]:::devtools
        TailwindProc["Tailwind CSS Processor"]:::devtools
    end

    %% Source Code
    subgraph "Source Code" 
        Public["public/"]:::source
        IndexHTML["index.html"]:::source
        PackageJSON["package.json"]:::source
        PackageLock["package-lock.json"]:::source
        ViteConfig["vite.config.mjs"]:::source
        TailwindConfig["tailwind.config.js"]:::source
        Manifest["public/manifest.json"]:::source
        Robots["public/robots.txt"]:::source

        Src["src/"]:::source
        MainJS["src/main.jsx"]:::source
        ReportVitals["src/reportWebVitals.jsx"]:::source
        IndexCSS["src/index.css"]:::source
        AppComp["src/App.jsx"]:::source
        ComponentsDir["src/Components"]:::source
        SidebarComp["src/Components/Sidebar.jsx"]:::source
        IntroComp["src/Components/intro.jsx"]:::source
        ProjectsComp["src/Components/projects.jsx"]:::source
        ContactComp["src/Components/contact.jsx"]:::source
        FormField["src/Components/form.jsx"]:::source
        LangSelect["src/Components/lang.jsx"]:::source
        AssetsDir["src/assets/"]:::source
        ResumePDF["src/assets/Internship Resume.pdf"]:::source
        ImagesDir["src/images/"]:::source
        GeneralIcons["src/images/general-icons"]:::source
        PurpleIcons["src/images/purple-icons"]:::source
    end

    %% Build Pipeline
    subgraph "Build Pipeline" 
        BuildCmd["npm run build"]:::devtools
        Bundle["Optimized Bundle (build/)"]:::source
    end

    %% CI/CD
    subgraph "CI/CD Pipeline"
        CI["GitHub Actions / Netlify Build Hooks"]:::devtools
    end

    %% Production Phase
    subgraph "Production Phase"
        Host["Static Hosting / CDN"]:::hosting
        Browser["End-User Browser"]:::browser
    end

    %% Relationships
    Editor -->|edits| IndexHTML
    Editor -->|edits| Src
    NodeNpm -->|runs| BuildCmd
    Vite -->|compiles src/ + assets| Bundle
    TailwindProc -->|processes CSS| Bundle

    IndexHTML -->|template| Bundle
    Public --> IndexHTML
    Public --> Manifest
    Public --> Robots

    Src --> MainJS
    Src --> ReportVitals
    Src --> IndexCSS
    Src --> AppComp
    Src --> ComponentsDir
    ComponentsDir --> SidebarComp
    ComponentsDir --> IntroComp
    ComponentsDir --> ProjectsComp
    ComponentsDir --> ContactComp
    ComponentsDir --> FormField
    ComponentsDir --> LangSelect
    Src --> AssetsDir
    AssetsDir --> ResumePDF
    Src --> ImagesDir
    ImagesDir --> GeneralIcons
    ImagesDir --> PurpleIcons

    BuildCmd --> Bundle
    CI -->|on push trigger build| BuildCmd
    CI -->|deploy| Host

    Bundle -->|deploy| Host
    Host -->|HTTP GET /index.html and assets| Browser
    Browser -->|loads SPA| AppComp
    Browser -->|navigates client-side| AppComp

    %% Click Events
    click IndexHTML "https://github.com/awanish-26/folio/blob/main/index.html"
    click PackageJSON "https://github.com/awanish-26/folio/blob/main/package.json"
    click PackageLock "https://github.com/awanish-26/folio/blob/main/package-lock.json"
    click ViteConfig "https://github.com/awanish-26/folio/blob/main/vite.config.mjs"
    click TailwindConfig "https://github.com/awanish-26/folio/blob/main/tailwind.config.js"
    click Manifest "https://github.com/awanish-26/folio/blob/main/public/manifest.json"
    click Robots "https://github.com/awanish-26/folio/blob/main/public/robots.txt"
    click MainJS "https://github.com/awanish-26/folio/blob/main/src/main.jsx"
    click ReportVitals "https://github.com/awanish-26/folio/blob/main/src/reportWebVitals.jsx"
    click IndexCSS "https://github.com/awanish-26/folio/blob/main/src/index.css"
    click AppComp "https://github.com/awanish-26/folio/blob/main/src/App.jsx"
    click ComponentsDir "https://github.com/awanish-26/folio/tree/main/src/Components"
    click SidebarComp "https://github.com/awanish-26/folio/blob/main/src/Components/Sidebar.jsx"
    click IntroComp "https://github.com/awanish-26/folio/blob/main/src/Components/intro.jsx"
    click ProjectsComp "https://github.com/awanish-26/folio/blob/main/src/Components/projects.jsx"
    click ContactComp "https://github.com/awanish-26/folio/blob/main/src/Components/contact.jsx"
    click FormField "https://github.com/awanish-26/folio/blob/main/src/Components/form.jsx"
    click LangSelect "https://github.com/awanish-26/folio/blob/main/src/Components/lang.jsx"
    click ResumePDF "https://github.com/awanish-26/folio/blob/main/src/assets/Internship Resume.pdf"
    click GeneralIcons "https://github.com/awanish-26/folio/tree/main/src/images/general-icons"
    click PurpleIcons "https://github.com/awanish-26/folio/tree/main/src/images/purple-icons"

    %% Styles
    classDef devtools fill:#D0E8FF,stroke:#0066CC,color:#003366
    classDef source fill:#FFE4B5,stroke:#FF8C00,color:#804000
    classDef hosting fill:#DFF2D8,stroke:#3C763D,color:#2E542C
    classDef browser fill:#EEEEEE,stroke:#888888,color:#333333
```
