# harshaltupe12/portfolio architecture

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

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

## Overview

##### Project type and purpose
- This is a Next.js–based personal/portfolio website that uses React for UI, Tailwind CSS for styling, and Next.js’s App Router for file-based routing and SSR/SSG capabilities. There is no separate “backend” folder—Next.js itself handles server-side rendering, static export, and API routes (none defined here).

##### File structure
- Top level:
- app/ — Next.js App Router directory containing page routes (page.jsx files), shared layout (layout.tsx), global CSS, and nested sub-routes (about, contact, etc.).
- components/ — reusable React UI components, further subdivided into:
– magicui/ — custom “theme” or “design system” primitives (aura-button, aurora-text).
– ui/ — generic, animated, 3D, or theme-provider components.
– SchemaMarkup.tsx for SEO/schema.
- lib/ — application-level utilities (utils.ts).
- utils/ — small helper scripts (cn.ts for classnames, skill-image.js, skills.js).
- public/ — static assets served directly (SVGs, robots.txt, sitemap, manifest).
- config files — next.config.mjs, tailwind.config.ts, postcss.config.js(mjs), tsconfig.json, package.json.

##### README for additional insights
- It’s a stock Next.js “create-next-app” scaffold.
- No mention of API routes or database—so it’s purely frontend with SSR/SSG.
- Deployed on Vercel (implied), serves static pages and assets, optimized fonts via next/font.

##### Elements
- Clear labels: Browser, CDN/Edge, Next.js Server, Page Renderer, Component Library, Styling Pipeline, Static Assets, Utilities, External Services
– Request flow (Client → CDN → Server → Client)
– Data/style flow (Tailwind config → CSS bundle → Client)
– Asset fetch (Client → CDN → public/)
– Purple for external services (Google Fonts, Analytics)

##### Final advice
1. Routing & SSR Engine (reads app/ tree, invokes React render)
- “layout” layer separately to show persistent UI
- Don’t forget to show the build step (+ Tailwind/PostCSS) as part of the CI/CD process if needed

## Diagram (Mermaid)

```mermaid
graph TD
    Browser["Browser"]:::runtime
    CDN["CDN / Vercel Edge"]:::runtime
    Server["Next.js Server\n(Node.js)"]:::runtime

    subgraph "Server Engines"
        Routing["Routing & SSR Engine\n(app/)"]:::runtime
    end

    Browser -->|HTTP GET| CDN
    CDN --> Server
    Server -->|"Serve HTML + JSON"| Browser
    Server -->|"Reads routes"| Routing

    subgraph "Page Renderer"
        Layout["Shared Layout\napp/layout.tsx"]:::frontend
        GlobalCSS["Global Styles\nglobals.css"]:::static
        subgraph "Pages"
            Home["Home\npage.tsx"]:::frontend
            About["About\npage.jsx"]:::frontend
            Contact["Contact\npage.jsx"]:::frontend
            Education["Education\npage.jsx"]:::frontend
            Projects["Projects\npage.jsx"]:::frontend
            SkillsPage["Skills\npage.jsx"]:::frontend
            Info["Info\npage.jsx"]:::frontend
            ContainerScroll["Container Scroll\npage.jsx"]:::frontend
            Flip["Flip Effect\npage.jsx"]:::frontend
            Terminal["Terminal\npage.jsx"]:::frontend
            Velocity["Velocity Scroll\npage.jsx"]:::frontend
            HomeAlt["Home Alt\npage.jsx"]:::frontend
        end
    end

    Routing --> Layout
    Routing --> GlobalCSS
    Routing --> Home
    Routing --> About
    Routing --> Contact
    Routing --> Education
    Routing --> Projects
    Routing --> SkillsPage
    Routing --> Info
    Routing --> ContainerScroll
    Routing --> Flip
    Routing --> Terminal
    Routing --> Velocity
    Routing --> HomeAlt

    click Routing "https://github.com/harshaltupe12/portfolio/tree/main/app/"
    click Layout "https://github.com/harshaltupe12/portfolio/blob/main/app/layout.tsx"
    click GlobalCSS "https://github.com/harshaltupe12/portfolio/blob/main/app/globals.css"
    click Home "https://github.com/harshaltupe12/portfolio/blob/main/app/page.tsx"
    click About "https://github.com/harshaltupe12/portfolio/blob/main/app/about/page.jsx"
    click Contact "https://github.com/harshaltupe12/portfolio/blob/main/app/contact/page.jsx"
    click Education "https://github.com/harshaltupe12/portfolio/blob/main/app/education/page.jsx"
    click Projects "https://github.com/harshaltupe12/portfolio/blob/main/app/projects/page.jsx"
    click SkillsPage "https://github.com/harshaltupe12/portfolio/blob/main/app/skills/page.jsx"
    click Info "https://github.com/harshaltupe12/portfolio/blob/main/app/info/page.jsx"
    click ContainerScroll "https://github.com/harshaltupe12/portfolio/blob/main/app/containerscroll/page.jsx"
    click Flip "https://github.com/harshaltupe12/portfolio/blob/main/app/flip/page.jsx"
    click Terminal "https://github.com/harshaltupe12/portfolio/blob/main/app/terminal/page.jsx"
    click Velocity "https://github.com/harshaltupe12/portfolio/blob/main/app/velocity/page.jsx"
    click HomeAlt "https://github.com/harshaltupe12/portfolio/blob/main/app/home/page.jsx"

    subgraph "Component Library"
        subgraph "MagicUI Primitives"
            AuraBtn["Aura Button"]:::logic
            AuroraText["Aurora Text"]:::logic
        end
        subgraph "UI Composites & Effects"
            Pin3D["3D Pin"]:::logic
            ButtonComp["Button"]:::logic
            CardHover["Card Hover Effect"]:::logic
            ContainerAnim["Container Scroll Animation"]:::logic
            Cover["Cover"]:::logic
            Dropdown["Dropdown Menu"]:::logic
            FlipWords["Flip Words"]:::logic
            HyperText["Hyper Text"]:::logic
            InfiniteCards["Infinite Moving Cards"]:::logic
            Meteors["Meteors Effect"]:::logic
            ScrollVelocity["Scroll-based Velocity"]:::logic
            Shine["Shine Border"]:::logic
            Sparkles["Sparkles"]:::logic
            TextGen["Text Generate Effect"]:::logic
            TextReveal["Text Reveal"]:::logic
            ThemeProvider["Theme Provider"]:::logic
            Timeline["Timeline"]:::logic
            Vortex["Vortex"]:::logic
            WarpBg["Warp Background"]:::logic
            WavyBg["Wavy Background"]:::logic
        end
    end

    Layout --> AuraBtn
    Layout --> ButtonComp
    Layout --> ThemeProvider

    click AuraBtn "https://github.com/harshaltupe12/portfolio/blob/main/components/magicui/aura-button.tsx"
    click AuroraText "https://github.com/harshaltupe12/portfolio/blob/main/components/magicui/aurora-text.tsx"
    click Pin3D "https://github.com/harshaltupe12/portfolio/blob/main/components/ui/3d-pin.tsx"
    click ButtonComp "https://github.com/harshaltupe12/portfolio/blob/main/components/ui/button.tsx"
    click CardHover "https://github.com/harshaltupe12/portfolio/blob/main/components/ui/card-hover-effect.tsx"
    click ContainerAnim "https://github.com/harshaltupe12/portfolio/blob/main/components/ui/container-scroll-animation.tsx"
    click Cover "https://github.com/harshaltupe12/portfolio/blob/main/components/ui/cover.tsx"
    click Dropdown "https://github.com/harshaltupe12/portfolio/blob/main/components/ui/dropdown-menu.tsx"
    click FlipWords "https://github.com/harshaltupe12/portfolio/blob/main/components/ui/flip-words.tsx"
    click HyperText "https://github.com/harshaltupe12/portfolio/blob/main/components/ui/hyper-text.tsx"
    click InfiniteCards "https://github.com/harshaltupe12/portfolio/blob/main/components/ui/infinite-moving-cards.tsx"
    click Meteors "https://github.com/harshaltupe12/portfolio/blob/main/components/ui/meteors.tsx"
    click ScrollVelocity "https://github.com/harshaltupe12/portfolio/blob/main/components/ui/scroll-based-velocity.tsx"
    click Shine "https://github.com/harshaltupe12/portfolio/blob/main/components/ui/shine-border.tsx"
    click Sparkles "https://github.com/harshaltupe12/portfolio/blob/main/components/ui/sparkles.tsx"
    click TextGen "https://github.com/harshaltupe12/portfolio/blob/main/components/ui/text-generate-effect.tsx"
    click TextReveal "https://github.com/harshaltupe12/portfolio/blob/main/components/ui/text-reveal.tsx"
    click ThemeProvider "https://github.com/harshaltupe12/portfolio/blob/main/components/ui/theme-provider.tsx"
    click Timeline "https://github.com/harshaltupe12/portfolio/blob/main/components/ui/timeline.tsx"
    click Vortex "https://github.com/harshaltupe12/portfolio/blob/main/components/ui/vortex.tsx"
    click WarpBg "https://github.com/harshaltupe12/portfolio/blob/main/components/ui/warp-background.tsx"
    click WavyBg "https://github.com/harshaltupe12/portfolio/blob/main/components/ui/wavy-background.tsx"

    subgraph "Utilities"
        General["General Utils\nlib/utils.ts"]:::logic
        Classnames["classnames Helper\nutils/cn.ts"]:::logic
        SkillImage["Skill Images Loader\nutils/skill-image.js"]:::logic
        SkillsData["Skills Data\nutils/skills.js"]:::logic
    end

    Pages --> General
    Pages --> Classnames
    Pages --> SkillImage
    Pages --> SkillsData

    click General "https://github.com/harshaltupe12/portfolio/blob/main/lib/utils.ts"
    click Classnames "https://github.com/harshaltupe12/portfolio/blob/main/utils/cn.ts"
    click SkillImage "https://github.com/harshaltupe12/portfolio/blob/main/utils/skill-image.js"
    click SkillsData "https://github.com/harshaltupe12/portfolio/blob/main/utils/skills.js"

    subgraph "Static Assets"
        Static["public/"]:::static
        RootFiles["robots.txt\nsitemap.xml\nsite.webmanifest\ngoogle*.html"]:::static
        SVGs["SVGs\npublic/svg/..."]:::static
    end

    Browser -->|Fetch assets| Static
    Static --> RootFiles
    Static --> SVGs

    click Static "https://github.com/harshaltupe12/portfolio/tree/main/public/"

    subgraph "Build & Styling Configuration"
        NextConfig["next.config.mjs"]:::logic
        TailwindConfig["tailwind.config.ts"]:::logic
        PostCSS["postcss.config.js/mjs"]:::logic
        TSConfig["tsconfig.json"]:::logic
    end

    Routing --> NextConfig
    Routing --> TailwindConfig
    Routing --> PostCSS
    Routing --> TSConfig

    click NextConfig "https://github.com/harshaltupe12/portfolio/blob/main/next.config.mjs"
    click TailwindConfig "https://github.com/harshaltupe12/portfolio/blob/main/tailwind.config.ts"
    click PostCSS "https://github.com/harshaltupe12/portfolio/blob/main/postcss.config.js"
    click TSConfig "https://github.com/harshaltupe12/portfolio/blob/main/tsconfig.json"

    subgraph "External Services"
        Fonts["Google Fonts"]:::external
        Analytics["Analytics"]:::external
    end

    Browser --> Fonts
    Browser --> Analytics

    classDef runtime fill:#cce5ff,stroke:#004085;
    classDef static fill:#d4edda,stroke:#155724;
    classDef logic fill:#ffeeba,stroke:#856404;
    classDef external fill:#e0bbff,stroke:#5a189a;
    classDef frontend fill:#bee5eb,stroke:#0c5460;
```
