# sumitkushwahji/portfolio architecture

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

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

## Overview

##### Project Type and Purpose
- This is a **front‐end only**, single‐page React.js portfolio website. It has no custom backend or database; it simply hosts static assets (HTML, JS, CSS, PDFs) and is built & deployed via a CI/CD pipeline (GitHub Actions → GitHub Pages or a similar static-hosting service).

##### File Structure
- **Top‐level**
- `.github/workflows/jekyll-gh-pages.yml` → CI/CD definition
- `public/` → Static HTML (`index.html`), manifest, robots.txt
- `src/` → React source code & assets
- `Images/` → Documentation screenshots
- `package.json` & `package-lock.json` → Build/dependency config
- **src/components/**
- `Navbar.js`, `Particle.js`, `Pre.js`, `ScrollToTop.js` → Generic UI components
- `Home/` → `Home.js`, `Home2.js`, `Type.js` → Hero section with typewriter effect
- `About/` → Bio cards, GitHub widget, tech/tool stacks
- `Projects/` → ProjectCards & Projects listing
- `Resume/` → ResumeNew component
- `Footer.js`
- Static PDFs in `src/Assets/Projects`

##### Extract Insights from the README
- Built with React.js, Node.js (for build), Express.js (mentioned but not used in code), React-Bootstrap, pure CSS
- Hosted as a static site (deploy via CI to Vercel or GitHub Pages)
- Responsive, multi-page layout simulated via client-side routing or anchored sections

##### Main Components
a. **Developer Environment**
– IDE & local Node.js/NPM → `npm install` & `npm start`
b. **Source Code Repository**
– GitHub repo holding `.github/`, `public/`, `src/`, `package.json`, `README.md`
c. **CI/CD Pipeline**
– GitHub Actions workflow (`jekyll-gh-pages.yml`):
- Checkout → npm ci → npm run build → deploy to GitHub Pages
d. **Hosting Service**
– GitHub Pages (or Vercel) serving the built static site via a CDN
e. **End User Browser**
– Issues an HTTP GET to the site URL → receives `index.html`, JS/CSS bundles, assets
f. **React App Runtime**
– `App.js` as root → renders Navbar, Particle effect, Preloader, ScrollToTop, Home, About, Projects, Resume, Footer

##### Relationships & Data Flow
- **Developer →** pushes code → **GitHub Repo**
- **GitHub Repo →** triggers **GitHub Actions**
- **GitHub Actions →** runs build → publishes output to **Hosting Service**
- **End User Browser →** fetches static site from **Hosting Service**
- **React App (in Browser) →** dynamically loads components, assets, PDFs, and renders UI

##### Architectural Patterns & Technologies
- **Component-Based Architecture (React)**: each UI section is a self-contained component
- **Static Site Deployment**: Build once, serve static bundles (no runtime server)
- **Continuous Deployment**: GitHub Actions → automatic publish on push to `main`
- **Asset Hosting**: PDFs and images are served alongside JS/CSS bundles

##### Detail Level
- **Top‐Level**: Developer, GitHub, CI/CD, Hosting, Browser
- **Mid‐Level**: Build process steps, static asset storage
- **Low‐Level (optional)**: React component tree

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Developer Environment
    subgraph "Developer Environment"
        Dev[/"Developer\n(IDE + Node.js/NPM)"/]:::env
    end

    %% Version Control & CI/CD
    subgraph "Version Control & CI/CD"
        Repo["GitHub Repository"]:::code
        CI["GitHub Actions\nWorkflow"]:::code
    end

    %% Build Output
    subgraph "Build Output"
        Build[("Static\nbuild/ folder")]:::storage
    end

    %% Hosting Service
    subgraph "Hosting Service"
        CDN(("GitHub Pages\n/CDN")):::external
    end

    %% Client Runtime
    subgraph "End User Browser"
        Browser[(Browser)]:::client
        subgraph "React App Runtime"
            App["App.js\n(Root Component)"]:::code
            Nav["Navbar"]:::code
            Part["Particle\nBackground"]:::code
            Pre["Preloader"]:::code
            Scroll["ScrollToTop"]:::code
            subgraph "Home Section"
                Home1["Home.js"]:::code
                Home2["Home2.js"]:::code
                Type["Type.js"]:::code
            end
            subgraph "About Section"
                About["About.js"]:::code
                AboutCard["AboutCard.js"]:::code
                GithubW["Github.js"]:::code
                Tech["Techstack.js"]:::code
                Tool["Toolstack.js"]:::code
            end
            subgraph "Projects Section"
                Projects["Projects.js"]:::code
                ProjCard["ProjectCards.js"]:::code
            end
            Resume["ResumeNew.js"]:::code
            Footer["Footer.js"]:::code
        end
    end

    %% Static Assets Storage
    subgraph "Static Assets"
        Public[("public/\nindex.html\nmanifest.json\nrobots.txt")]:::storage
        Assets[("src/Assets/\nPDF Resumes")]:::storage
        ImagesDir[("Images/\n(Screenshots)")]:::storage
    end

    %% Testing & Performance
    subgraph "Testing & Performance"
        Test["App.test.js"]:::code
        WebVitals["reportWebVitals.js"]:::code
        Setup["setupTests.js"]:::code
    end

    %% Global Config
    subgraph "Build & Dependency Config"
        PKG["package.json"]:::code
        PKGLock["package-lock.json"]:::code
    end

    %% Workflow
    Dev -->|"push code"| Repo
    Repo -->|"trigger build"| CI
    CI -->|"npm ci & npm run build"| Build
    CI -->|"deploy build"| CDN
    CDN -->|"serve assets"| Browser
    Browser -->|"GET /index.html"| CDN
    Browser --> App
    App --> Nav
    App --> Part
    App --> Pre
    App --> Scroll
    App --> Home1
    App --> About
    App --> Projects
    App --> Resume
    App --> Footer
    Home1 --> Home2
    Home2 --> Type
    Projects --> ProjCard
    About --> AboutCard
    About --> GithubW
    About --> Tech
    About --> Tool
    Browser --> Public
    Browser --> Assets
    Browser --> ImagesDir

    %% Click Events
    click CI "https://github.com/sumitkushwahji/portfolio/blob/main/.github/workflows/jekyll-gh-pages.yml"
    click Public "https://github.com/sumitkushwahji/portfolio/blob/main/public/index.html"
    click Public "https://github.com/sumitkushwahji/portfolio/blob/main/public/manifest.json"
    click Public "https://github.com/sumitkushwahji/portfolio/blob/main/public/robots.txt"
    click PKG "https://github.com/sumitkushwahji/portfolio/blob/main/package.json"
    click PKGLock "https://github.com/sumitkushwahji/portfolio/blob/main/package-lock.json"
    click App "https://github.com/sumitkushwahji/portfolio/blob/main/src/App.js"
    click Dev "https://github.com/sumitkushwahji/portfolio/blob/main/src/index.js"
    click Dev "https://github.com/sumitkushwahji/portfolio/blob/main/src/index.css"
    click Dev "https://github.com/sumitkushwahji/portfolio/blob/main/src/App.css"
    click Dev "https://github.com/sumitkushwahji/portfolio/blob/main/src/style.css"
    click Nav "https://github.com/sumitkushwahji/portfolio/blob/main/src/components/Navbar.js"
    click Part "https://github.com/sumitkushwahji/portfolio/blob/main/src/components/Particle.js"
    click Pre "https://github.com/sumitkushwahji/portfolio/blob/main/src/components/Pre.js"
    click Scroll "https://github.com/sumitkushwahji/portfolio/blob/main/src/components/ScrollToTop.js"
    click Home1 "https://github.com/sumitkushwahji/portfolio/blob/main/src/components/Home/Home.js"
    click Home2 "https://github.com/sumitkushwahji/portfolio/blob/main/src/components/Home/Home2.js"
    click Type "https://github.com/sumitkushwahji/portfolio/blob/main/src/components/Home/Type.js"
    click About "https://github.com/sumitkushwahji/portfolio/blob/main/src/components/About/About.js"
    click AboutCard "https://github.com/sumitkushwahji/portfolio/blob/main/src/components/About/AboutCard.js"
    click GithubW "https://github.com/sumitkushwahji/portfolio/blob/main/src/components/About/Github.js"
    click Tech "https://github.com/sumitkushwahji/portfolio/blob/main/src/components/About/Techstack.js"
    click Tool "https://github.com/sumitkushwahji/portfolio/blob/main/src/components/About/Toolstack.js"
    click Projects "https://github.com/sumitkushwahji/portfolio/blob/main/src/components/Projects/Projects.js"
    click ProjCard "https://github.com/sumitkushwahji/portfolio/blob/main/src/components/Projects/ProjectCards.js"
    click Resume "https://github.com/sumitkushwahji/portfolio/blob/main/src/components/Resume/ResumeNew.js"
    click Footer "https://github.com/sumitkushwahji/portfolio/blob/main/src/components/Footer.js"
    click Assets "https://github.com/sumitkushwahji/portfolio/blob/main/src/Assets/Soumyajit_Behera-BIT_MESRA.pdf"
    click Assets "https://github.com/sumitkushwahji/portfolio/blob/main/src/Assets/sumit_kushwah_resume_Full_Stack_Developer4.pdf"
    click ImagesDir "https://github.com/sumitkushwahji/portfolio/tree/main/Images/"
    click Test "https://github.com/sumitkushwahji/portfolio/blob/main/src/App.test.js"
    click WebVitals "https://github.com/sumitkushwahji/portfolio/blob/main/src/reportWebVitals.js"
    click Setup "https://github.com/sumitkushwahji/portfolio/blob/main/src/setupTests.js"

    %% Styles
    classDef code fill:#cce5ff,stroke:#4a90e2,color:#000;
    classDef storage fill:#e0e0e0,stroke:#888888,color:#000;
    classDef external fill:#e3dafe,stroke:#9f7aea,color:#000;
    classDef client fill:#ffe5b4,stroke:#fb8c00,color:#000;
    classDef env fill:#d1e7dd,stroke:#20c997,color:#000;
```
