# raakshit/web_portfolio architecture

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

- Interactive diagram: https://gitdiagram.com/raakshit/web_portfolio
- Repository: https://github.com/raakshit/web_portfolio

## Overview

##### Project type and purpose
- This is a single‐page application (SPA) built with Create React App.
- It serves as a marketing/presentation website, composed entirely of React components and static assets—no dedicated backend or API logic is present in the repo.

##### Top-level structure and architectural patterns
- public/
- index.html – the SPA container
- manifest.json, robots.txt, favicon, etc.
- src/
- index.js – React DOM bootstrap
- App.js (+ App.css) – root component and layout
- Components/ – folder of reusable UI building blocks (Banner, About, Services, etc.)
- assets/ – raw images, fonts, media
- styling & tooling: tailwind.config.js, postcss.config.js
- package.json – declares dependencies (react, react-dom, tailwindcss, etc.), dev‐scripts, and build configuration
- CRA build pipeline (webpack, Babel) is hidden behind “npm start” / “npm run build”

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Developer/CI Environment
    subgraph "Developer/CI Environment"
        Dev["Developer Machine / CI"]:::external
        npmStart["npm start"]:::build
        npmBuild["npm run build"]:::build
        Dev -->|runs| npmStart
        Dev -->|runs| npmBuild
    end

    %% Build Pipeline
    subgraph "Build Pipeline"
        WebpackDev["Webpack Dev Server"]:::build
        WebpackBundler["Webpack Bundler + Babel"]:::build
        TailwindConfig["tailwind.config.js"]:::artifact
        PostCSSConfig["postcss.config.js"]:::artifact
        GlobalCSS["src/index.css"]:::artifact
        npmStart -->|serves dev assets| WebpackDev
        WebpackDev -->|hot reload| Dev
        npmBuild -->|bundles| WebpackBundler
        WebpackBundler -->|reads config| TailwindConfig
        WebpackBundler -->|reads config| PostCSSConfig
        WebpackBundler -->|injects CSS| GlobalCSS
        WebpackBundler -->|outputs| BuildFolder["/build folder"]:::artifact
    end

    %% Runtime/Hosting & Client
    subgraph "Runtime / Hosting & Client"
        Host["Static Host / CDN"]:::runtime
        Browser["Web Browser"]:::runtime
        Host -->|serves index.html + bundles| Browser
        Browser -->|loads SPA| ReactApp["React SPA"]:::runtime
    end

    %% React SPA Internal Structure
    subgraph "React SPA"
        IndexJS["React DOM Bootstrap (src/index.js)"]:::artifact
        AppJS["React Root Component & Layout (src/App.js)"]:::artifact
        ComponentsDir["UI Component Library (src/Components/)"]:::artifact
        AssetsDir["Asset Store (src/assets/ + public/)"]:::artifact
        StylingEngine["Styling Engine (Tailwind + PostCSS)"]:::build
        IndexJS -->|hydrates| AppJS
        AppJS -->|composes| ComponentsDir
        AppJS -->|uses styles from| StylingEngine
        AppJS -->|loads assets from| AssetsDir
    end

    %% Component Details
    Banner["Banner Component"]:::artifact
    About["About Section Component"]:::artifact
    Services["Services Section Component"]:::artifact
    ClientReviews["Client Reviews Component"]:::artifact
    Expertise["Expertise Section Component"]:::artifact
    PreviousWork["Previous Work Section Component"]:::artifact
    OurImpact["Our Impact Section Component"]:::artifact
    Footer["Footer Component"]:::artifact
    ContactUs["Contact Us Form Module"]:::artifact

    ComponentsDir --> Banner
    ComponentsDir --> About
    ComponentsDir --> Services
    ComponentsDir --> ClientReviews
    ComponentsDir --> Expertise
    ComponentsDir --> PreviousWork
    ComponentsDir --> OurImpact
    ComponentsDir --> Footer
    AppJS --> ContactUs

    %% Public Assets
    PublicHTML["SPA Container HTML (public/index.html)"]:::artifact
    Manifest["Web App Manifest (public/manifest.json)"]:::artifact
    Robots["Robots Exclusion File (public/robots.txt)"]:::artifact

    Host --> PublicHTML
    Host --> Manifest
    Host --> Robots

    %% Package Definition
    PackageJSON["Package & Scripts Definition (package.json)"]:::artifact
    Dev --> PackageJSON

    %% Click Events
    click IndexJS "https://github.com/raakshit/web_portfolio/blob/main/src/index.js"
    click AppJS "https://github.com/raakshit/web_portfolio/blob/main/src/App.js"
    click ComponentsDir "https://github.com/raakshit/web_portfolio/tree/main/src/Components/"
    click Banner "https://github.com/raakshit/web_portfolio/blob/main/src/Components/Banner.jsx"
    click About "https://github.com/raakshit/web_portfolio/blob/main/src/Components/About.jsx"
    click Services "https://github.com/raakshit/web_portfolio/blob/main/src/Components/Services.jsx"
    click ClientReviews "https://github.com/raakshit/web_portfolio/blob/main/src/Components/ClientReviews.jsx"
    click Expertise "https://github.com/raakshit/web_portfolio/blob/main/src/Components/Expertise.jsx"
    click PreviousWork "https://github.com/raakshit/web_portfolio/blob/main/src/Components/PreviousWork.jsx"
    click OurImpact "https://github.com/raakshit/web_portfolio/blob/main/src/Components/OurImpact.jsx"
    click Footer "https://github.com/raakshit/web_portfolio/blob/main/src/Components/Footer.jsx"
    click ContactUs "https://github.com/raakshit/web_portfolio/blob/main/src/ContactUs.js"
    click TailwindConfig "https://github.com/raakshit/web_portfolio/blob/main/tailwind.config.js"
    click PostCSSConfig "https://github.com/raakshit/web_portfolio/blob/main/postcss.config.js"
    click GlobalCSS "https://github.com/raakshit/web_portfolio/blob/main/src/index.css"
    click PublicHTML "https://github.com/raakshit/web_portfolio/blob/main/public/index.html"
    click Manifest "https://github.com/raakshit/web_portfolio/blob/main/public/manifest.json"
    click Robots "https://github.com/raakshit/web_portfolio/blob/main/public/robots.txt"
    click PackageJSON "https://github.com/raakshit/web_portfolio/blob/main/package.json"

    %% Styles
    classDef runtime fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef build fill:#90EE90,stroke:#333,stroke-width:1px
    classDef artifact fill:#FFD580,stroke:#333,stroke-width:1px
    classDef external fill:#EEEEEE,stroke:#333,stroke-width:1px
```
