# vaibhavbhardwaj-2396/vaibhavbhardwaj_portfolio architecture

> Architecture diagram of the GitHub repository vaibhavbhardwaj-2396/vaibhavbhardwaj_portfolio, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-10-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vaibhavbhardwaj-2396/vaibhavbhardwaj_portfolio
- Repository: https://github.com/vaibhavbhardwaj-2396/vaibhavbhardwaj_portfolio

## Overview

##### Project type and purpose
- This is a full-stack personal portfolio site with a built-in blog and admin dashboard.
- The front end is a TypeScript React SPA powered by Vite and styled with Tailwind CSS.
- The back end is built on Supabase (PostgreSQL + Auth + REST), with Cloudinary for media storage, and is deployed as a serverless site on Netlify.

##### File structure
- Top-level:
- dist/ – production build artifacts (CSS, JS, index.html) served by Netlify
- src/ – application source code
- supabase/ – database migrations for schema evolution
- config files: tailwind.config.js, vite.config.ts, netlify.toml, tsconfig*.json
- src/ breakdown:
- assets/ – static images (logo, hero background)
- components/ – UI split into subfolders:
– admin/ (AdminLogin, Dashboard, BlogManager, editors, DataTable, etc.)
– blog/ (BlogLayout, BlogList, filters, CTAs, newsletter modals)
– layout/ (Header, shared wrappers)
– sections/ (Home, About, Skills, Experience, Contact, etc.)
– common widgets (Counter, CustomCursor, ThemeToggle, LoadingBuffer)
- hooks/ – custom hooks (useSecretCode) for admin access
- lib/ – wrappers for external services (supabase.ts, cloudinary.ts, database.ts, blog.ts)
- main.tsx / App.tsx – SPA entry point

##### README
- The README title “Vaibhavbhardwaj_portfolio” confirms a personal portfolio with blogging and admin functionality.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Front-end Client
    Browser["User Browser"]:::frontend

    subgraph "React SPA" 
        direction TB
        main["main.tsx"]:::frontend
        app["App.tsx"]:::frontend
        viteCfg["vite.config.ts"]:::frontend
        ts1["tsconfig.json"]:::frontend
        ts2["tsconfig.app.json"]:::frontend
        ts3["tsconfig.node.json"]:::frontend
        tail1["tailwind.config.js"]:::frontend
        tail2["postcss.config.js"]:::frontend
        comp["src/components/"]:::frontend
        assets["src/assets/"]:::frontend
        hooks["useSecretCode.ts"]:::frontend
        lib["src/lib/"]:::frontend
    end

    subgraph "Hosting (Netlify)" 
        direction TB
        net1["netlify.toml"]:::hosting
        net2["_redirects"]:::hosting
        dist["dist/"]:::hosting
    end

    subgraph "Back-end Services" 
        direction TB
        supaAPI["Supabase Auth & REST API"]:::service
        db["PostgreSQL DB"]:::service
        cloud["Cloudinary"]:::external
    end

    subgraph "CI/CD & Infra" 
        direction TB
        ci["CI/CD Pipeline"]:::infra
        migrations["supabase/migrations/"]:::infra
        stackCfg["stackbit.config.ts"]:::infra
        pkg1["package.json"]:::infra
        pkg2["package-lock.json"]:::infra
    end

    %% Data Flows
    Browser -->|"GET App"| dist
    dist --> Browser
    Browser -->|"REST API calls"| supaAPI
    Browser -->|"Upload media"| cloud
    supaAPI -->|"queries"| db
    ci -->|"run migrations"| migrations
    migrations --> supaAPI
    ci -->|"build & deploy"| dist

    %% Click Events
    click main "https://github.com/vaibhavbhardwaj-2396/vaibhavbhardwaj_portfolio/blob/main/src/main.tsx"
    click app "https://github.com/vaibhavbhardwaj-2396/vaibhavbhardwaj_portfolio/blob/main/src/App.tsx"
    click viteCfg "https://github.com/vaibhavbhardwaj-2396/vaibhavbhardwaj_portfolio/blob/main/vite.config.ts"
    click ts1 "https://github.com/vaibhavbhardwaj-2396/vaibhavbhardwaj_portfolio/blob/main/tsconfig.json"
    click ts2 "https://github.com/vaibhavbhardwaj-2396/vaibhavbhardwaj_portfolio/blob/main/tsconfig.app.json"
    click ts3 "https://github.com/vaibhavbhardwaj-2396/vaibhavbhardwaj_portfolio/blob/main/tsconfig.node.json"
    click tail1 "https://github.com/vaibhavbhardwaj-2396/vaibhavbhardwaj_portfolio/blob/main/tailwind.config.js"
    click tail2 "https://github.com/vaibhavbhardwaj-2396/vaibhavbhardwaj_portfolio/blob/main/postcss.config.js"
    click comp "https://github.com/vaibhavbhardwaj-2396/vaibhavbhardwaj_portfolio/tree/main/src/components/"
    click assets "https://github.com/vaibhavbhardwaj-2396/vaibhavbhardwaj_portfolio/tree/main/src/assets/"
    click hooks "https://github.com/vaibhavbhardwaj-2396/vaibhavbhardwaj_portfolio/blob/main/src/hooks/useSecretCode.ts"
    click lib "https://github.com/vaibhavbhardwaj-2396/vaibhavbhardwaj_portfolio/tree/main/src/lib/"
    click net1 "https://github.com/vaibhavbhardwaj-2396/vaibhavbhardwaj_portfolio/blob/main/netlify.toml"
    click net2 "https://github.com/vaibhavbhardwaj-2396/vaibhavbhardwaj_portfolio/tree/main/_redirects"
    click dist "https://github.com/vaibhavbhardwaj-2396/vaibhavbhardwaj_portfolio/tree/main/dist/"
    click migrations "https://github.com/vaibhavbhardwaj-2396/vaibhavbhardwaj_portfolio/tree/main/supabase/migrations/"
    click stackCfg "https://github.com/vaibhavbhardwaj-2396/vaibhavbhardwaj_portfolio/blob/main/stackbit.config.ts"
    click pkg1 "https://github.com/vaibhavbhardwaj-2396/vaibhavbhardwaj_portfolio/blob/main/package.json"
    click pkg2 "https://github.com/vaibhavbhardwaj-2396/vaibhavbhardwaj_portfolio/blob/main/package-lock.json"

    %% Styles
    classDef frontend fill:#E1F5FE,stroke:#0288D1,stroke-width:1px
    classDef hosting fill:#ECEFF1,stroke:#455A64,stroke-width:1px
    classDef service fill:#E8F5E9,stroke:#2E7D32,stroke-width:1px
    classDef external fill:#FFF3E0,stroke:#F57C00,stroke-width:1px
    classDef infra fill:#F3E5F5,stroke:#6A1B9A,stroke-width:1px
```
