# aaryanharshalpawar/aaryan-pawar-persona-web architecture

> Architecture diagram of the GitHub repository aaryanharshalpawar/aaryan-pawar-persona-web, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aaryanharshalpawar/aaryan-pawar-persona-web
- Repository: https://github.com/aaryanharshalpawar/aaryan-pawar-persona-web

## Overview

##### Project type and purpose
- This is a TypeScript-based, single-page web application (SPA) built with React and Vite.
- It uses shadcn-ui (a set of Radix-powered, Tailwind CSS-styled components) to render UI primitives.
- There is no backend or server logic in this repo—this project focuses entirely on the client side.

##### File structure
- Top-level files and folders
– package.json, tsconfig.json, vite.config.ts, tailwind.config.ts → build and dev server configuration
– public/ → static assets (robots.txt, favicon, etc.)
– src/ → the heart of the application
- src/ sub-structure
– main.tsx → entry point, mounts React tree to index.html
– App.tsx → root component, holds routing/navigation logic
– pages/ → routeable components (Home, About, Contact, Index, NotFound)
– components/ → reusable feature components (AuthDialog, Navigation)
– components/ui/ → low-level UI primitives (button, card, dialog, tooltip, etc.)
– hooks/ → custom React hooks (useMobile, useToast)
– lib/ → helper utilities (utils.ts)
- Config and build scripts
– vite.config.ts & tsconfig.*.json define compilation, module resolution, and path aliases
– tailwind.config.ts & postcss.config.js for styling pipeline

##### README for additional insights
- Confirms tech stack (Vite, TypeScript, React, shadcn-ui, Tailwind)
- Describes development workflows via Lovable, IDE, or Codespaces
- Mentions hosting and custom domain setup via Lovable platform
- No backend or API references → purely static front-end

a. Main components to represent
– Developer environment
- IDE or Lovable web editor
- Git repository (GitHub)
– Build & CI/CD
- Vite development server (hot-reload)
- Vite build pipeline → output to dist/
- Optional CI/CD step (Git hooks or Lovable auto-deploy)
– Deployment & hosting
- Lovable hosting platform (static asset CDN)
- Custom domain DNS configuration
– Runtime application
- Browser running React SPA
- React root → App.tsx → Router layer → pages
- Components layer → feature & UI primitives
- Tailwind & shadcn-ui as styling/rendering engines
b. Relationships and interactions
- Developer commits → Git push → (CI/CD) → Vite build → deploy static files
- Browser requests index.html → loads JS/CSS bundles → React hydration
- App.tsx uses router to render pages → pages compose feature components → UI primitives call hooks/utilities
c. Architectural patterns & design principles
- Component-driven architecture (atomic design pattern for UI)
- Separation of concerns: routing vs pages vs components vs UI primitives vs utilities
- Declarative styling via Tailwind + shadcn-ui wrappers
- Client-only SPA model—no server logic in repo
d. Key technologies & libraries
- React & React Router (or similar) for client routing
- Vite for ES module dev server + bundler
- TypeScript for static typing
- Tailwind CSS for utility-first styling
- shadcn-ui (Radix UI underpinnings) for accessible components
- Custom hooks (useMobile, useToast) for shared state/behavior

##### Detail without overcomplicating
- Essential layers: developer tools, build pipeline, hosting, runtime application
- Interactions between layers rather than every single file

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Developer Environment
    subgraph "Developer Environment" 
        direction TB
        IDE["IDE / Codespaces"]:::dev
        Git["Git Repository (GitHub)"]:::dev
    end

    IDE -->|commits code| Git

    %% Build & CI/CD
    subgraph "Build & CI/CD" 
        direction TB
        ViteDev["Vite Dev Server"]:::build
        ViteBuild["Vite Build Pipeline"]:::build
        CI["CI/CD (Lovable Auto-Deploy)"]:::build
    end

    Git -->|push| CI -->|trigger| ViteDev
    CI -->|build| ViteBuild

    click ViteDev "https://github.com/aaryanharshalpawar/aaryan-pawar-persona-web/blob/main/vite.config.ts"
    click ViteBuild "https://github.com/aaryanharshalpawar/aaryan-pawar-persona-web/blob/main/vite.config.ts"

    %% Config Files
    subgraph "Config & Styling" 
        direction TB
        TSConfig["TypeScript Configs"]:::build
        Tailwind["Tailwind Config & PostCSS"]:::build
        Public["Static Assets (public/)"]:::build
        HTML["HTML Template (index.html)"]:::build
    end

    ViteDev --> TSConfig
    ViteBuild --> Tailwind
    ViteBuild --> Public
    ViteBuild --> HTML

    click TSConfig "https://github.com/aaryanharshalpawar/aaryan-pawar-persona-web/blob/main/tsconfig.json"
    click TSConfig "https://github.com/aaryanharshalpawar/aaryan-pawar-persona-web/blob/main/tsconfig.app.json"
    click TSConfig "https://github.com/aaryanharshalpawar/aaryan-pawar-persona-web/blob/main/tsconfig.node.json"
    click Tailwind "https://github.com/aaryanharshalpawar/aaryan-pawar-persona-web/blob/main/tailwind.config.ts"
    click Tailwind "https://github.com/aaryanharshalpawar/aaryan-pawar-persona-web/blob/main/postcss.config.js"
    click Public "https://github.com/aaryanharshalpawar/aaryan-pawar-persona-web/tree/main/public/"
    click HTML "https://github.com/aaryanharshalpawar/aaryan-pawar-persona-web/blob/main/index.html"

    %% Deployment & Hosting
    subgraph "Deployment & Hosting" 
        direction TB
        Lovable["Lovable Hosting Platform (CDN)"]:::ext
        DNS["Custom Domain DNS"]:::ext
    end

    ViteBuild -->|deploy static files| Lovable
    Lovable --> DNS

    %% Runtime Application
    subgraph "Runtime Application (Browser)" 
        direction TB
        Browser["Browser"]:::runtime
        IndexHTML["index.html"]:::runtime
        MainTS["src/main.tsx"]:::runtime
        AppRoot["src/App.tsx"]:::runtime
        Router["Router Layer"]:::runtime
        Pages["Pages Layer"]:::runtime
        Components["Feature Components"]:::runtime
        UIPrimitives["UI Primitives Layer"]:::runtime
        HooksUtils["Hooks & Utils"]:::util
    end

    Lovable --> Browser
    Browser --> IndexHTML
    IndexHTML --> MainTS
    MainTS --> AppRoot
    AppRoot --> Router
    Router --> Pages
    Pages --> Components
    Components --> UIPrimitives
    UIPrimitives --> HooksUtils

    click MainTS "https://github.com/aaryanharshalpawar/aaryan-pawar-persona-web/blob/main/src/main.tsx"
    click AppRoot "https://github.com/aaryanharshalpawar/aaryan-pawar-persona-web/blob/main/src/App.tsx"
    click Pages "https://github.com/aaryanharshalpawar/aaryan-pawar-persona-web/tree/main/src/pages/"
    click Pages "https://github.com/aaryanharshalpawar/aaryan-pawar-persona-web/blob/main/src/pages/Home.tsx"
    click Pages "https://github.com/aaryanharshalpawar/aaryan-pawar-persona-web/blob/main/src/pages/About.tsx"
    click Pages "https://github.com/aaryanharshalpawar/aaryan-pawar-persona-web/blob/main/src/pages/Contact.tsx"
    click Pages "https://github.com/aaryanharshalpawar/aaryan-pawar-persona-web/blob/main/src/pages/Index.tsx"
    click Pages "https://github.com/aaryanharshalpawar/aaryan-pawar-persona-web/blob/main/src/pages/NotFound.tsx"
    click Components "https://github.com/aaryanharshalpawar/aaryan-pawar-persona-web/tree/main/src/components/"
    click Components "https://github.com/aaryanharshalpawar/aaryan-pawar-persona-web/blob/main/src/components/AuthDialog.tsx"
    click Components "https://github.com/aaryanharshalpawar/aaryan-pawar-persona-web/blob/main/src/components/Navigation.tsx"
    click UIPrimitives "https://github.com/aaryanharshalpawar/aaryan-pawar-persona-web/tree/main/src/components/ui/"
    click UIPrimitives "https://github.com/aaryanharshalpawar/aaryan-pawar-persona-web/blob/main/src/components/ui/button.tsx"
    click UIPrimitives "https://github.com/aaryanharshalpawar/aaryan-pawar-persona-web/blob/main/src/components/ui/card.tsx"
    click UIPrimitives "https://github.com/aaryanharshalpawar/aaryan-pawar-persona-web/blob/main/src/components/ui/dialog.tsx"
    click UIPrimitives "https://github.com/aaryanharshalpawar/aaryan-pawar-persona-web/blob/main/src/components/ui/tooltip.tsx"
    click HooksUtils "https://github.com/aaryanharshalpawar/aaryan-pawar-persona-web/tree/main/src/hooks/"
    click HooksUtils "https://github.com/aaryanharshalpawar/aaryan-pawar-persona-web/blob/main/src/hooks/use-mobile.tsx"
    click HooksUtils "https://github.com/aaryanharshalpawar/aaryan-pawar-persona-web/blob/main/src/hooks/use-toast.ts"
    click HooksUtils "https://github.com/aaryanharshalpawar/aaryan-pawar-persona-web/blob/main/src/lib/utils.ts"

    %% Stylesheet
    CSS["Global Styles (src/index.css, src/App.css)"]:::util
    MainTS --> CSS
    AppRoot --> CSS

    classDef dev fill:#D6B5FF,stroke:#7D4CDB,color:#000
    classDef build fill:#A3D5FF,stroke:#1E90FF,color:#000
    classDef ext fill:#FFD59E,stroke:#FF8C00,color:#000
    classDef runtime fill:#B5F5B0,stroke:#2E8B57,color:#000
    classDef util fill:#E0E0E0,stroke:#A0A0A0,color:#000
```
