# aakash-73/my_portfolio architecture

> Architecture diagram of the GitHub repository aakash-73/my_portfolio, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-02-23). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aakash-73/my_portfolio
- Repository: https://github.com/aakash-73/my_portfolio

## Overview

##### Project type + purpose (what you’re diagramming)
This repo is a **static, client-side single-page portfolio website** built with:
- **React 18** (component UI)
- **Vite** (dev server + bundling)
- **Tailwind CSS + PostCSS** (styling pipeline)
- **Framer Motion** (animations)

There is **no backend service** and **no database** in the repository. “Full Stack” in the README refers to the *portfolio theme/content*, not the architecture.

From the tree:

##### Runtime (browser) artifacts
- `index.html` – the HTML entry point Vite serves and injects the bundle into.
- `src/main.jsx` – bootstraps React (creates root, mounts `<App />`).
- `src/App.jsx` – top-level composition of sections.
- `src/components/*` – page/section components (Hero/Header, About, Experience, Projects, Skills, Education, Contact, etc.).
- `src/data.js` – **central content model** (resume data in one place).
- `src/index.css` – global styles (plus Tailwind directives/overrides).
- `src/assets/` – static assets (images, etc., if present).

##### Tooling / build-time artifacts
- `package.json` / `package-lock.json` – dependencies, scripts (`dev`, `build`, `preview`).
- `vite.config.js` – Vite configuration (build outputs to `dist/`).
- `postcss.config.js` – PostCSS pipeline (Tailwind + autoprefixing).
- `.github/workflows/deploy.yml` – CI/CD automation for deployment (likely GitHub Pages or similar).
- `.gitignore`, `.github/*` – repo hygiene + automation.

##### Main components
For accuracy, split into **Runtime (client)** and **Build/Deploy** lanes.

##### React App
- **Entry**: `main.jsx`
- **Root**: `App.jsx`
- `Header.jsx` (Hero + Navigation)
- `PersonalSticker.jsx` (animated branding centerpiece)
- `GeometricBackground.jsx` (visual background system)
- `About.jsx`, `Experience.jsx`, `Projects.jsx`, `Skills.jsx`, `Education.jsx`, `Contact.jsx`
##### Content/Data Layer
- `data.js` as the single source of truth for content
##### Animation/Interaction
- Framer Motion (used inside components)

##### Developer Machine
- `npm run dev` → Vite Dev Server (HMR)
##### CI/CD
- GitHub Actions: `.github/workflows/deploy.yml`
##### Build Toolchain
- Vite Build (`npm run build`) → outputs `dist/`
- PostCSS + Tailwind compilation → generates final CSS
##### Hosting
- GitHub Pages / Netlify / Vercel (README lists options)
##### End Users
- fetch static assets (HTML/CSS/JS) from hosting CDN/origin

##### Architectural patterns/design principles evident here
- **Component-based UI architecture** (React): sections are separate components.
- **Data-driven rendering**: `src/data.js` is the content source; components consume it.
- **Separation of concerns**:
- Content (`data.js`)
- Presentation/behavior (`components/*.jsx`)
- Global styling (`index.css` + Tailwind config)
- Build tooling (`vite`, PostCSS, Tailwind)
- Deployment automation (GitHub Actions)
- **SPA delivery model**: static assets served; no server-side rendering indicated.

- Containers: Browser, Static Hosting/CDN, React SPA bundle
- Inside React SPA: major subsystems (Sections, Data, Styling, Animation)

- Developer → GitHub → GitHub Actions → Vite build → dist/ → Hosting → Users

- Lane 1: *Developer/CI*
- Lane 2: *Hosting*
- Lane 3: *Browser Runtime*

- “Entry Point” → `src/main.jsx`
- “App Shell / Section Orchestrator” → `src/App.jsx`
- “Content Model (Resume Data)” → `src/data.js`
- “Sections” → `src/components/{Header,About,Experience,Projects,Skills,Education,Contact}.jsx`
- “Branding/Animation Centerpiece” → `src/components/PersonalSticker.jsx`
- “Background System” → `src/components/GeometricBackground.jsx`
- “Styling” → `tailwind.config.js`, `src/index.css`, `postcss.config.js`
- “Bundler/Dev Server” → `vite.config.js` (Vite)
- “CI/CD” → `.github/workflows/deploy.yml`
- “Static Build Output” → `dist/` (generated)

##### “As many components as possible” (without inventing architecture)
To increase detail while staying true:
- Break “Components” into:
- **Layout & Navigation**: `Header.jsx`
- **Brand/Visual**: `PersonalSticker.jsx`, `GeometricBackground.jsx`
- **Content Sections**: About/Experience/Projects/Skills/Education/Contact
- Break “Styling” into:
- Tailwind theme tokens (`tailwind.config.js`)
- Global CSS (`index.css`)
- PostCSS pipeline (`postcss.config.js`)
- Break “Build” into:
- Dev mode (Vite dev server + HMR)
- Prod build (Vite bundling)
- Preview (`npm run preview`)

## Diagram (Mermaid)

```mermaid
flowchart TD
  %% =========================
  %% Build / Deploy (Top Lane)
  %% =========================
  subgraph BD["Build & Deploy (Tooling + CI/CD)"]
    Dev["Developer Machine"]:::external
    Pkg["Dependencies & Scripts (package.json)"]:::tooling
    Lock["Lockfile (package-lock.json)"]:::tooling
    Git["GitHub Repo"]:::external

    subgraph CICD["CI/CD"]
      GHA["Deploy Workflow (deploy.yml)"]:::cicd
    end

    subgraph Toolchain["Build Toolchain"]
      ViteCfg["Bundler/Dev Server Config (vite.config.js)"]:::tooling
      TailwindCfg["Tailwind Theme Tokens (tailwind.config.js)"]:::tooling
      PostCSSCfg["PostCSS Pipeline (postcss.config.js)"]:::tooling
      Build["Vite Build (npm run build)"]:::build
      Dist["Static Build Output (dist/)"]:::artifact
    end

    Host["Static Hosting (GitHub Pages/Netlify/Vercel)"]:::external
    ViteDev["Vite Dev Server (HMR)"]:::build

    Dev -->|"npm_run_dev"| ViteDev
    Dev -->|"git_push"| Git
    Git -->|"trigger_on_push"| GHA
    GHA -->|"npm_ci_or_install"| Pkg
    Pkg -->|"resolves_versions"| Lock
    GHA -->|"npm_run_build"| Build
    ViteCfg -->|"configures"| Build
    TailwindCfg -->|"theme_tokens"| Build
    PostCSSCfg -->|"css_pipeline"| Build
    Build -->|"emit_assets"| Dist
    Dist -->|"publish"| Host
  end

  %% =========================
  %% Runtime / Browser (Bottom Lane)
  %% =========================
  subgraph RT["Runtime (Client-side SPA in Browser)"]
    User["End User"]:::external
    Browser["Browser"]:::external

    subgraph Delivery["Static Delivery"]
      Index["HTML Entry Point (index.html)"]:::artifact
      Bundle["Bundled Assets (JS/CSS)"]:::artifact
      Assets["Static Assets (src/assets/)"]:::artifact
    end

    subgraph SPA["React SPA"]
      Main["Entry Point (main.jsx)"]:::frontend
      App["App Shell / Section Orchestrator (App.jsx)"]:::frontend

      subgraph Sections["Sections / UI Components (src/components/*)"]
        Header["Header / Hero + Navigation (Header.jsx)"]:::frontend
        Sticker["Branding/Animation Centerpiece (PersonalSticker.jsx)"]:::frontend
        GeoBG["Background System (GeometricBackground.jsx)"]:::frontend
        About["About (About.jsx)"]:::frontend
        Exp["Experience (Experience.jsx)"]:::frontend
        Proj["Projects (Projects.jsx)"]:::frontend
        Skills["Skills (Skills.jsx)"]:::frontend
        Edu["Education (Education.jsx)"]:::frontend
        Contact["Contact (Contact.jsx)"]:::frontend
      end

      Data["Content Model (Resume Data) (data.js)"]:::data
      CSS["Global Styles / Tailwind Directives (index.css)"]:::styling
      Tailwind["Tailwind Utility Classes"]:::styling
      Motion["Framer Motion"]:::lib
      Icons["React Icons"]:::lib
      Links["External Links (mailto / LinkedIn / GitHub)"]:::external
    end

    User -->|"interact"| Browser
    Browser -->|"GET_/index.html"| Host
    Host -->|"serve"| Index
    Browser -->|"GET_/assets/*.js"| Host
    Browser -->|"GET_/assets/*.css"| Host
    Browser -->|"GET_/assets/*"| Host
    Host -->|"serve"| Bundle
    Host -->|"serve"| Assets

    Index -->|"loads"| Bundle
    Bundle -->|"executes"| Main
    Main -->|"mount"| App

    App -->|"render_compose"| Header
    App -->|"render_compose"| Sticker
    App -->|"render_compose"| GeoBG
    App -->|"render_compose"| About
    App -->|"render_compose"| Exp
    App -->|"render_compose"| Proj
    App -->|"render_compose"| Skills
    App -->|"render_compose"| Edu
    App -->|"render_compose"| Contact

    Header -->|"import_content"| Data
    Sticker -->|"import_content"| Data
    About -->|"import_content"| Data
    Exp -->|"import_content"| Data
    Proj -->|"import_content"| Data
    Skills -->|"import_content"| Data
    Edu -->|"import_content"| Data
    Contact -->|"import_content"| Data

    App -->|"styles"| CSS
    CSS -->|"tailwind_directives"| Tailwind

    Header -->|"animate"| Motion
    Sticker -->|"animate"| Motion
    GeoBG -->|"animate"| Motion
    About -->|"animate"| Motion
    Exp -->|"animate"| Motion
    Proj -->|"animate"| Motion
    Skills -->|"animate"| Motion
    Edu -->|"animate"| Motion
    Contact -->|"animate"| Motion

    Header -->|"icons"| Icons
    Contact -->|"open_links"| Links
  end

  %% =========================
  %% Notes / Principles (Legend-like)
  %% =========================
  subgraph Notes["Architecture Notes"]
    N1["Component-based_UI_(React_sections_are_components)"]:::note
    N2["Data-driven_rendering_(single_source:_data.js)"]:::note
    N3["Separation_of_concerns_(content/presentation/styling/tooling/deploy)"]:::note
    N4["SPA_delivery_(static_assets_only,_no_backend_or_DB)"]:::note
  end

  %% =========================
  %% Click Events (from component_mapping)
  %% =========================
  click Index "https://github.com/aakash-73/my_portfolio/blob/main/index.html"
  click Main "https://github.com/aakash-73/my_portfolio/blob/main/src/main.jsx"
  click App "https://github.com/aakash-73/my_portfolio/blob/main/src/App.jsx"
  click Header "https://github.com/aakash-73/my_portfolio/blob/main/src/components/Header.jsx"
  click Sticker "https://github.com/aakash-73/my_portfolio/blob/main/src/components/PersonalSticker.jsx"
  click GeoBG "https://github.com/aakash-73/my_portfolio/blob/main/src/components/GeometricBackground.jsx"
  click About "https://github.com/aakash-73/my_portfolio/blob/main/src/components/About.jsx"
  click Exp "https://github.com/aakash-73/my_portfolio/blob/main/src/components/Experience.jsx"
  click Proj "https://github.com/aakash-73/my_portfolio/blob/main/src/components/Projects.jsx"
  click Skills "https://github.com/aakash-73/my_portfolio/blob/main/src/components/Skills.jsx"
  click Edu "https://github.com/aakash-73/my_portfolio/blob/main/src/components/Education.jsx"
  click Contact "https://github.com/aakash-73/my_portfolio/blob/main/src/components/Contact.jsx"
  click Data "https://github.com/aakash-73/my_portfolio/blob/main/src/data.js"
  click CSS "https://github.com/aakash-73/my_portfolio/blob/main/src/index.css"
  click Assets "https://github.com/aakash-73/my_portfolio/tree/main/src/assets/"
  click Pkg "https://github.com/aakash-73/my_portfolio/blob/main/package.json"
  click Lock "https://github.com/aakash-73/my_portfolio/blob/main/package-lock.json"
  click ViteCfg "https://github.com/aakash-73/my_portfolio/blob/main/vite.config.js"
  click TailwindCfg "https://github.com/aakash-73/my_portfolio/blob/main/tailwind.config.js"
  click PostCSSCfg "https://github.com/aakash-73/my_portfolio/blob/main/postcss.config.js"
  click GHA "https://github.com/aakash-73/my_portfolio/blob/main/.github/workflows/deploy.yml"

  %% Repo hygiene
  click N4 "https://github.com/aakash-73/my_portfolio/blob/main/.gitignore"

  %% =========================
  %% Styles
  %% =========================
  classDef frontend fill:#1d4ed8,stroke:#0b2a6f,color:#ffffff,stroke-width:1px
  classDef styling fill:#7c3aed,stroke:#3b0764,color:#ffffff,stroke-width:1px
  classDef data fill:#0f766e,stroke:#042f2e,color:#ffffff,stroke-width:1px
  classDef lib fill:#0369a1,stroke:#082f49,color:#ffffff,stroke-width:1px
  classDef tooling fill:#f59e0b,stroke:#7c2d12,color:#111827,stroke-width:1px
  classDef build fill:#22c55e,stroke:#14532d,color:#052e16,stroke-width:1px
  classDef cicd fill:#16a34a,stroke:#14532d,color:#052e16,stroke-width:1px
  classDef artifact fill:#94a3b8,stroke:#334155,color:#0f172a,stroke-width:1px
  classDef external fill:#6b7280,stroke:#111827,color:#ffffff,stroke-width:1px
  classDef note fill:#fef3c7,stroke:#92400e,color:#451a03,stroke-width:1px
```
