# helllobc/ishaan-rai09 architecture

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

- Interactive diagram: https://gitdiagram.com/helllobc/ishaan-rai09
- Repository: https://github.com/helllobc/ishaan-rai09

## Overview

##### Project type and purpose
- From the README (“This is my Portfolio Website”) and the file tree (no `backend` folder, only `src`, `public`, build configs), this is a single-page React/TypeScript front-end application built with Vite and Tailwind CSS.
- Purpose: to showcase an individual’s work, skills, and projects in a navigable, visually appealing manner.

##### File structure
- Top level
– Configuration and build files: `vite.config.ts`, `postcss.config.js`, `tailwind.config.ts`, `tsconfig.json`
– App entrypoints: `index.html`, `src/main.tsx`, `src/index.css`
– Public assets: `public/robots.txt`
- Source directory (`src`)
– `pages/`: top-level page components (Index, Contact, Projects, Skills, NotFound)
– `components/`: reusable visual pieces (Hero, Navigation, Preloader) and a large `ui/` subfolder containing atomic UI components (buttons, dialogs, inputs, etc.)
– `hooks/`: custom React hooks (`use-mobile`, `use-toast`)
– `lib/`: utility functions (`utils.ts`)
- No server or API layer in this codebase; it outputs a static bundle.

##### README for additional insights
- We infer from `package.json` (not shown) that dependencies include React, Vite, Tailwind, and possibly a component library scaffold.

## Diagram (Mermaid)

```mermaid
graph TD
    %% External Entities
    Developer["Developer Workstation (IDE, Git)"]:::external
    CICD["CI/CD Pipeline"]:::build
    ViteBuild["Vite Build"]:::build
    StaticHosting["Static Hosting / CDN"]:::hosting
    Browser["User's Browser"]:::external

    %% Build & Tooling Configuration
    subgraph "Build & Configuration"
        ViteConfig["vite.config.ts"]:::build
        TailwindConfig["tailwind.config.ts"]:::build
        PostCSSConfig["postcss.config.js"]:::build
        TSConfig["tsconfig.json / tsconfig.app.json / tsconfig.node.json"]:::build
    end

    Developer -->|"push code"| CICD
    CICD -->|"run build"| ViteBuild
    ViteBuild --> ViteConfig
    ViteBuild --> TailwindConfig
    ViteBuild --> PostCSSConfig
    ViteBuild --> TSConfig
    ViteBuild -->|"output static assets"| StaticHosting
    StaticHosting -->|"serves assets"| Browser

    %% Client-Side Application
    subgraph "Client-Side (Browser)" 
        direction TB
        indexHTML["index.html"]:::client
        mainTSX["src/main.tsx"]:::client
        AppTSX["src/App.tsx"]:::client
        Router["Routing Layer"]:::client
        subgraph "Pages"
            direction TB
            Home["Home Page (Index)"]:::client
            Contact["Contact Page"]:::client
            Projects["Projects Page"]:::client
            Skills["Skills Page"]:::client
            NotFound["404 Not Found Page"]:::client
        end
        subgraph "Components"
            direction TB
            Hero["Hero Section"]:::component
            Navigation["Navigation Bar"]:::component
            Preloader["Preloader Animation"]:::component
        end
        subgraph "UI Component Library"
            direction TB
            UIFolder["src/components/ui/*"]:::component
        end
        subgraph "Hooks & Utilities"
            direction TB
            Hooks["Custom Hooks"]:::util
            subgraph "Hooks"
                MobileHook["use-mobile"]:::util
                ToastHook["use-toast"]:::util
            end
            Utils["src/lib/utils.ts"]:::util
        end
        indexHTML --> mainTSX
        mainTSX --> AppTSX
        AppTSX --> Router
        Router --> Home
        Router --> Contact
        Router --> Projects
        Router --> Skills
        Router --> NotFound
        AppTSX --> Hero
        AppTSX --> Navigation
        AppTSX --> Preloader
        AppTSX --> UIFolder
        AppTSX --> MobileHook
        AppTSX --> ToastHook
        AppTSX --> Utils
        mainTSX -->|"imports styles"| IndexCSS
        AppTSX -->|"imports styles"| AppCSS
    end

    %% Global Styles
    IndexCSS["src/index.css"]:::build
    AppCSS["src/App.css"]:::build

    %% Public Assets
    Robots["public/robots.txt"]:::external
    StaticHosting --> Robots

    %% Click Events
    click indexHTML "https://github.com/helllobc/ishaan-rai09/blob/main/index.html"
    click mainTSX "https://github.com/helllobc/ishaan-rai09/blob/main/src/main.tsx"
    click AppTSX "https://github.com/helllobc/ishaan-rai09/blob/main/src/App.tsx"
    click IndexCSS "https://github.com/helllobc/ishaan-rai09/blob/main/src/index.css"
    click AppCSS "https://github.com/helllobc/ishaan-rai09/blob/main/src/App.css"
    click Home "https://github.com/helllobc/ishaan-rai09/blob/main/src/pages/Index.tsx"
    click Contact "https://github.com/helllobc/ishaan-rai09/blob/main/src/pages/Contact.tsx"
    click Projects "https://github.com/helllobc/ishaan-rai09/blob/main/src/pages/Projects.tsx"
    click Skills "https://github.com/helllobc/ishaan-rai09/blob/main/src/pages/Skills.tsx"
    click NotFound "https://github.com/helllobc/ishaan-rai09/blob/main/src/pages/NotFound.tsx"
    click Hero "https://github.com/helllobc/ishaan-rai09/blob/main/src/components/Hero.tsx"
    click Navigation "https://github.com/helllobc/ishaan-rai09/blob/main/src/components/Navigation.tsx"
    click Preloader "https://github.com/helllobc/ishaan-rai09/blob/main/src/components/Preloader.tsx"
    click UIFolder "https://github.com/helllobc/ishaan-rai09/tree/main/src/components/ui"
    click MobileHook "https://github.com/helllobc/ishaan-rai09/blob/main/src/hooks/use-mobile.tsx"
    click ToastHook "https://github.com/helllobc/ishaan-rai09/blob/main/src/hooks/use-toast.ts"
    click Utils "https://github.com/helllobc/ishaan-rai09/blob/main/src/lib/utils.ts"
    click Robots "https://github.com/helllobc/ishaan-rai09/blob/main/public/robots.txt"
    click ViteConfig "https://github.com/helllobc/ishaan-rai09/blob/main/vite.config.ts"
    click TailwindConfig "https://github.com/helllobc/ishaan-rai09/blob/main/tailwind.config.ts"
    click PostCSSConfig "https://github.com/helllobc/ishaan-rai09/blob/main/postcss.config.js"
    click TSConfig "https://github.com/helllobc/ishaan-rai09/blob/main/tsconfig.json"

    %% Styles
    classDef external fill:#cccccc,stroke:#333,stroke-width:1px
    classDef build fill:#bbdefb,stroke:#1e88e5,stroke-width:1px
    classDef hosting fill:#c8e6c9,stroke:#388e3c,stroke-width:1px
    classDef client fill:#ffe0b2,stroke:#fb8c00,stroke-width:1px
    classDef component fill:#ffe082,stroke:#ffa000,stroke-width:1px
    classDef util fill:#d1c4e9,stroke:#7e57c2,stroke-width:1px
```
