# devbyritesh/portfolio architecture

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

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

## Overview

##### Project Type and Purpose
- This is a single-page, static front-end portfolio application built with React (via Vite) and TypeScript.
- It showcases personal information, projects, skills, and includes a contact form integration.
- It uses Tailwind CSS for styling and a custom UI component library under src/components/ui.

##### File Structure Analysis
- Top-level:
- index.html, public/ — static entry point and assets
- vite.config.ts, tailwind.config.ts — build and styling configuration
- src/ — application source
- src/ breakdown:
- pages/ — route entry components (Index.tsx, NotFound.tsx)
- components/ — high-level page sections (About, Projects, Contact, etc.)
- components/ui/ — reusable UI primitives (buttons, dialogs, forms, etc.)
- hooks/ — custom React hooks for global behavior (use-mobile, use-toast)
- lib/ — utility functions
- main.tsx & App.tsx — application bootstrap and routing
- No server-side code: static front-end that likely posts form data to a third-party API or serverless function.

##### Key Insights from README
- Built with React.js (Vite) and Tailwind CSS.
- Hosted on a static host (Render/Vercel/Netlify).
- Contact form integration and downloadable resume.
- Emphasis on responsive design, animations, dark mode.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Development & Deployment
    subgraph "Development & Deployment"
        Dev["Developer"]:::dev
        GitHub["GitHub (Source Repo)"]:::dev
        CICD["CI/CD Pipeline"]:::dev
        ViteConfig["vite.config.ts"]:::dev
        TailwindConfig["tailwind.config.ts"]:::dev
        PostCSS["postcss.config.js"]:::dev
    end

    Dev -->|commits code| GitHub
    GitHub -->|triggers| CICD
    CICD -->|runs build using| ViteConfig
    CICD -->|runs build using| TailwindConfig
    CICD -->|runs build using| PostCSS
    CICD -->|deploys static assets| Host

    click ViteConfig "https://github.com/devbyritesh/portfolio/blob/main//vite.config.ts"
    click TailwindConfig "https://github.com/devbyritesh/portfolio/blob/main//tailwind.config.ts"
    click PostCSS "https://github.com/devbyritesh/portfolio/blob/main//postcss.config.js"

    %% Hosting & CDN
    subgraph "Hosting & CDN"
        Host["Static Host (Render/Vercel/Netlify)"]:::hosting
        CDN["CDN"]:::hosting
    end

    CICD -->|uploads assets| Host
    Host -->|serves via| CDN

    %% Client-Side Application
    subgraph "Client-Side Application"
        Browser["Browser (SPA)"]:::client
        entry["index.html"]:::client
        Main["main.tsx"]:::client
        App["App.tsx (Router)"]:::client

        subgraph Pages
            Index["Index.tsx"]:::client
            NotFound["NotFound.tsx"]:::client
        end

        subgraph "Page-Level Components"
            Hero["Hero.tsx"]:::client
            About["About.tsx"]:::client
            Projects["Projects.tsx"]:::client
            Experience["Experience.tsx"]:::client
            Skills["Skills.tsx"]:::client
            Strengths["Strengths.tsx"]:::client
            Certificates["Certificates.tsx"]:::client
            TextClass["TextClassification.tsx"]:::client
            ContactComp["Contact.tsx"]:::client
            Navbar["Navbar.tsx"]:::client
        end

        subgraph "UI Primitives Library"
            UIPkg["/src/components/ui/"]:::client
            Button["button.tsx"]:::client
            Dialog["dialog.tsx"]:::client
            Input["input.tsx"]:::client
            Checkbox["checkbox.tsx"]:::client
            Radio["radio-group.tsx"]:::client
            Textarea["textarea.tsx"]:::client
            Menubar["menubar.tsx"]:::client
            NavMenu["navigation-menu.tsx"]:::client
            Alert["alert.tsx"]:::client
            Toast["toast.tsx"]:::client
            Toaster["toaster.tsx"]:::client
            Card["card.tsx"]:::client
            Accordion["accordion.tsx"]:::client
            Sheet["sheet.tsx"]:::client
            Sidebar["sidebar.tsx"]:::client
        end

        subgraph "Hooks & Utilities"
            UseMobile["use-mobile.tsx"]:::client
            UseToast["use-toast.ts"]:::client
            Utils["utils.ts"]:::client
        end

        subgraph "Styles"
            GlobalCSS["index.css"]:::client
            AppCSS["App.css"]:::client
        end
    end

    %% Client flow
    Browser -->|GET index.html| CDN
    CDN -->|delivers| entry
    entry -->|loads| Main
    Main -->|mounts| App
    App -->|routes to| Index
    App -->|routes to| NotFound
    App -->|renders| Navbar
    Index -->|uses| Hero
    Index -->|uses| About
    Index -->|uses| Projects
    Index -->|uses| Experience
    Index -->|uses| Skills
    Index -->|uses| Strengths
    Index -->|uses| Certificates
    Index -->|uses| TextClass
    App -->|renders| ContactComp

    %% UI primitives usage
    Hero -->|uses| UIPkg
    About -->|uses| UIPkg
    Projects -->|uses| UIPkg
    Experience -->|uses| UIPkg
    Skills -->|uses| UIPkg
    Strengths -->|uses| UIPkg
    Certificates -->|uses| UIPkg
    TextClass -->|uses| UIPkg
    ContactComp -->|uses| UIPkg
    Navbar -->|uses| UIPkg

    UIPkg --> Button
    UIPkg --> Dialog
    UIPkg --> Input
    UIPkg --> Checkbox
    UIPkg --> Radio
    UIPkg --> Textarea
    UIPkg --> Menubar
    UIPkg --> NavMenu
    UIPkg --> Alert
    UIPkg --> Toast
    UIPkg --> Toaster
    UIPkg --> Card
    UIPkg --> Accordion
    UIPkg --> Sheet
    UIPkg --> Sidebar

    %% Hooks & Utils usage
    App -->|calls hook| UseMobile
    App -->|calls hook| UseToast
    Hero -->|calls util| Utils
    About -->|calls util| Utils

    UseMobile -->|provides state| App
    UseToast -->|provides state| App

    %% External Integrations
    subgraph "External Integrations"
        ContactAPI["Contact Form API"]:::external
        Analytics["Analytics Service"]:::external
    end

    ContactComp -->|POST contact data| ContactAPI
    App -->|loads script| Analytics

    %% Click events for file mappings
    click entry "https://github.com/devbyritesh/portfolio/blob/main//index.html"
    click Browser "https://github.com/devbyritesh/portfolio/tree/main/ignore"
    click Index "https://github.com/devbyritesh/portfolio/blob/main//src/pages/Index.tsx"
    click NotFound "https://github.com/devbyritesh/portfolio/blob/main//src/pages/NotFound.tsx"
    click Hero "https://github.com/devbyritesh/portfolio/blob/main//src/components/Hero.tsx"
    click About "https://github.com/devbyritesh/portfolio/blob/main//src/components/About.tsx"
    click Projects "https://github.com/devbyritesh/portfolio/blob/main//src/components/Projects.tsx"
    click Experience "https://github.com/devbyritesh/portfolio/blob/main//src/components/Experience.tsx"
    click Skills "https://github.com/devbyritesh/portfolio/blob/main//src/components/Skills.tsx"
    click Strengths "https://github.com/devbyritesh/portfolio/blob/main//src/components/Strengths.tsx"
    click Certificates "https://github.com/devbyritesh/portfolio/blob/main//src/components/Certificates.tsx"
    click TextClass "https://github.com/devbyritesh/portfolio/blob/main//src/components/TextClassification.tsx"
    click ContactComp "https://github.com/devbyritesh/portfolio/blob/main//src/components/Contact.tsx"
    click Navbar "https://github.com/devbyritesh/portfolio/blob/main//src/components/Navbar.tsx"
    click Main "https://github.com/devbyritesh/portfolio/blob/main//src/main.tsx"
    click App "https://github.com/devbyritesh/portfolio/blob/main//src/App.tsx"
    click UIPkg "https://github.com/devbyritesh/portfolio/tree/main//src/components/ui/"
    click Button "https://github.com/devbyritesh/portfolio/blob/main//src/components/ui/button.tsx"
    click Dialog "https://github.com/devbyritesh/portfolio/blob/main//src/components/ui/dialog.tsx"
    click Input "https://github.com/devbyritesh/portfolio/blob/main//src/components/ui/input.tsx"
    click Checkbox "https://github.com/devbyritesh/portfolio/blob/main//src/components/ui/checkbox.tsx"
    click Radio "https://github.com/devbyritesh/portfolio/blob/main//src/components/ui/radio-group.tsx"
    click Textarea "https://github.com/devbyritesh/portfolio/blob/main//src/components/ui/textarea.tsx"
    click Menubar "https://github.com/devbyritesh/portfolio/blob/main//src/components/ui/menubar.tsx"
    click NavMenu "https://github.com/devbyritesh/portfolio/blob/main//src/components/ui/navigation-menu.tsx"
    click Alert "https://github.com/devbyritesh/portfolio/blob/main//src/components/ui/alert.tsx"
    click Toast "https://github.com/devbyritesh/portfolio/blob/main//src/components/ui/toast.tsx"
    click Toaster "https://github.com/devbyritesh/portfolio/blob/main//src/components/ui/toaster.tsx"
    click Card "https://github.com/devbyritesh/portfolio/blob/main//src/components/ui/card.tsx"
    click Accordion "https://github.com/devbyritesh/portfolio/blob/main//src/components/ui/accordion.tsx"
    click Sheet "https://github.com/devbyritesh/portfolio/blob/main//src/components/ui/sheet.tsx"
    click Sidebar "https://github.com/devbyritesh/portfolio/blob/main//src/components/ui/sidebar.tsx"
    click UseMobile "https://github.com/devbyritesh/portfolio/blob/main//src/hooks/use-mobile.tsx"
    click UseToast "https://github.com/devbyritesh/portfolio/blob/main//src/hooks/use-toast.ts"
    click Utils "https://github.com/devbyritesh/portfolio/blob/main//src/lib/utils.ts"
    click GlobalCSS "https://github.com/devbyritesh/portfolio/blob/main//src/index.css"
    click AppCSS "https://github.com/devbyritesh/portfolio/blob/main//src/App.css"

    %% Styles for color coding
    classDef dev fill:#D0E6FF,stroke:#0050B3,color:#000;
    classDef hosting fill:#DFFFE0,stroke:#008000,color:#000;
    classDef client fill:#FFE6C0,stroke:#B35900,color:#000;
    classDef external fill:#F0D0FF,stroke:#800080,color:#000;
```
