# jeet6421/my-portfolio architecture

> Architecture diagram of the GitHub repository jeet6421/my-portfolio, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jeet6421/my-portfolio
- Repository: https://github.com/jeet6421/my-portfolio

## Overview

##### Project Type and Purpose
- This is a full-stack web application built with Next.js (React) – specifically a personal portfolio/resume site.
- It uses server-side rendering (SSR) or static site generation (SSG) for pages in the `app/` directory, and serves static assets (PDF resume, images) from `public/` and `assets/public/`.

##### File Structure Analysis
- app/
– components/ (React UI components: About, Contact, Header, Footer, Navbar, Projects, Resume)
– globals.css (global Tailwind styles)
– layout.js (application shell with common layout)
– page.js (root page entrypoint)
- assets/
– assets.js (dynamic imports of images/assets)
– public/ (raw assets like sample-resume.pdf)
- public/ (static hosting root – jitendrachoudharyfullstackresume.pdf)
- Configuration & Build
– next.config.mjs (Next.js config)
– tailwind.config.mjs & postcss.config.mjs (Tailwind CSS pipeline)
– eslint.config.mjs
– jsconfig.json
– package.json / package-lock.json

##### Key Architectural Patterns & Design Principles
- Component-based UI (React)
- File-system routing (Next.js “app” router)
- Separation of concerns:
- Presentation (app/components)
- Layout & routing (layout.js / page.js)
- Static assets (public/ & assets/)
- CSS utility framework (Tailwind via PostCSS)
- Optimized font loading with next/font

##### Main Components
A. Client Browser
B. Next.js Serverless Runtime (Vercel or Node.js)
C. Routing & Rendering Layer
- “app” router – page.js & layout.js
- React Components (app/components/*.jsx)
D. Static Assets Layer
- public/ (PDFs, images)
- assets/public/ (sample PDF)
E. Build & Deployment Pipeline
- npm / pnpm scripts (dev, build, start)
- Tailwind & PostCSS
- next.config.mjs
- CI/CD (Vercel)
F. External Services
- next/font CDN (Geist font from Vercel)

##### Relationships & Data Flow
1. Browser → HTTP GET `/` or `/about` → Next.js Server
2. Routing Layer resolves route from `app/page.js` or `app/components/*`
3. React components render HTML (SSR/SSG)
4. CSS pipeline applies Tailwind classes via global.css + postcss
5. Font assets loaded from next/font CDN
6. Static asset requests (`/sample-resume.pdf`) served directly from public/ or assets/public/
7. Build step bundles JS/CSS and deploys via Vercel

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Global Entities
    Browser["Client Browser"]:::external

    %% Next.js Runtime
    NextServer["Next.js Serverless Runtime"]:::service

    %% External Services
    CDN["next/font CDN"]:::external

    %% Routing & Rendering Layer
    subgraph "Routing & Rendering Layer"
        DirectionalRouting["app/page.js"]:::ui
        Layout["app/layout.js"]:::ui
        Styles["app/globals.css"]:::ui
    end

    %% UI Components Layer
    subgraph "UI Components Layer"
        About["About.jsx"]:::ui
        Contact["Contact.jsx"]:::ui
        Footer["Footer.jsx"]:::ui
        Header["Header.jsx"]:::ui
        Navbar["Navbar.jsx"]:::ui
        Projects["Projects.jsx"]:::ui
        ResumeComp["Resume.jsx"]:::ui
    end

    %% Static Assets Layer
    subgraph "Static Assets Layer"
        PublicPDF["jitendrachoudharyfullstackresume.pdf"]:::storage
        AssetsJS["assets/assets.js"]:::storage
        SamplePDF["sample-resume.pdf"]:::storage
    end

    %% Build & Deployment Pipeline
    subgraph "Build & Deployment Pipeline"
        NextConfig["next.config.mjs"]:::build
        TailwindConfig["tailwind.config.mjs"]:::build
        PostCSS["postcss.config.mjs"]:::build
        ESLint["eslint.config.mjs"]:::build
        JSConfig["jsconfig.json"]:::build
        PackageJSON["package.json\n&\npackage-lock.json"]:::build
        CICDPipeline["CI/CD (Vercel)"]:::build
    end

    %% Connections
    Browser -->|"HTTP GET / or /about"| NextServer
    NextServer -->|"resolves route"| DirectionalRouting
    DirectionalRouting -->|"uses layout"| Layout
    DirectionalRouting -->|"imports styles"| Styles
    DirectionalRouting -->|"renders"| About
    DirectionalRouting -->|"renders"| Contact
    DirectionalRouting -->|"renders"| Footer
    DirectionalRouting -->|"renders"| Header
    DirectionalRouting -->|"renders"| Navbar
    DirectionalRouting -->|"renders"| Projects
    DirectionalRouting -->|"renders"| ResumeComp
    NextServer -->|"serves static assets"| PublicPDF
    NextServer -->|"serves static assets"| SamplePDF
    NextServer -->|"fetch font assets"| CDN
    NextConfig -->|builds| NextServer
    TailwindConfig -->|builds| NextServer
    PostCSS -->|builds| NextServer
    ESLint -->|builds| NextServer
    JSConfig -->|builds| NextServer
    PackageJSON -->|builds| NextServer
    NextServer -->|deployed via| CICDPipeline

    %% Click Events
    click DirectionalRouting "https://github.com/jeet6421/my-portfolio/blob/master/app/page.js"
    click Layout "https://github.com/jeet6421/my-portfolio/blob/master/app/layout.js"
    click Styles "https://github.com/jeet6421/my-portfolio/blob/master/app/globals.css"
    click About "https://github.com/jeet6421/my-portfolio/blob/master/app/components/About.jsx"
    click Contact "https://github.com/jeet6421/my-portfolio/blob/master/app/components/Contact.jsx"
    click Footer "https://github.com/jeet6421/my-portfolio/blob/master/app/components/Footer.jsx"
    click Header "https://github.com/jeet6421/my-portfolio/blob/master/app/components/Header.jsx"
    click Navbar "https://github.com/jeet6421/my-portfolio/blob/master/app/components/Navbar.jsx"
    click Projects "https://github.com/jeet6421/my-portfolio/blob/master/app/components/Projects.jsx"
    click ResumeComp "https://github.com/jeet6421/my-portfolio/blob/master/app/components/Resume.jsx"
    click PublicPDF "https://github.com/jeet6421/my-portfolio/blob/master/public/jitendrachoudharyfullstackresume.pdf"
    click AssetsJS "https://github.com/jeet6421/my-portfolio/blob/master/assets/assets.js"
    click SamplePDF "https://github.com/jeet6421/my-portfolio/blob/master/assets/public/sample-resume.pdf"
    click NextConfig "https://github.com/jeet6421/my-portfolio/blob/master/next.config.mjs"
    click TailwindConfig "https://github.com/jeet6421/my-portfolio/blob/master/tailwind.config.mjs"
    click PostCSS "https://github.com/jeet6421/my-portfolio/blob/master/postcss.config.mjs"
    click ESLint "https://github.com/jeet6421/my-portfolio/blob/master/eslint.config.mjs"
    click JSConfig "https://github.com/jeet6421/my-portfolio/blob/master/jsconfig.json"
    click PackageJSON "https://github.com/jeet6421/my-portfolio/blob/master/package.json"
    click CICDPipeline "https://github.com/jeet6421/my-portfolio/blob/master/package.json"

    %% Styles
    classDef ui fill:#E3F2FD,stroke:#1E88E5,color:#0D47A1
    classDef service fill:#BBDEFB,stroke:#1976D2,color:#0D47A1
    classDef storage fill:#FFF3E0,stroke:#FB8C00,color:#E65100
    classDef build fill:#E8F5E9,stroke:#43A047,color:#1B5E20
    classDef external fill:#ECEFF1,stroke:#90A4AE,color:#37474F
```
