# srummanf/vetrina architecture

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

- Interactive diagram: https://gitdiagram.com/srummanf/vetrina
- Repository: https://github.com/srummanf/vetrina

## Overview

##### Project Type & Purpose
- This is a Next.js (v13+) full-stack web application serving a personal portfolio/vitrina.
- It uses the “app” directory (App Router), server and client components, static data modules, and a small API route to fetch “Now Playing” data from Spotify.
- No traditional database—data comes from TS modules under `data/` and external APIs.

##### File Structure
- Top-level directories:
– app/: Next.js App Router (pages, layouts, API routes)
– components/: React UI components
– data/: static content (projects, location, shayari)
– hooks/: custom React hooks
– lib/: shared utilities
– public/: static assets (images, sounds, sitemap, robots.txt)
– font/: custom font assets
– styles/: global CSS
- Config & metadata: next.config.ts, tsconfig.json, package.json, postcss.config.mjs
- API: app/api/np/route.ts (serverless function for Spotify Now Playing)

##### README
- Minimal decorative README; no extra architecture docs.

##### Core Components & Interactions
a. Frontend (Next.js React):
– app/layout.tsx: Root layout
– app/page.tsx + nested pages (projects, lets-meet, not-found)
– components/*: Presentational and interactive UI
– hooks/useClick.ts: Client hook for click sounds
b. Backend / Serverless:
– API Route at /api/np: Fetches Spotify Now Playing via external HTTP
– Server Components (default in app/), Client Components (marked with “use client”)
c. Static Data & Assets:
– data/*.ts: Inlined content at build/SSR time
– public/: Static files served via CDN (images, sounds, robots.txt, sitemap)
– font/: Custom fonts loaded via CSS
d. External Service:
– Spotify Web API (for now‐playing information)

##### Architectural Patterns & Principles
- App Router with nested layouts and server/client boundary
- Static generation & SSR: Data in modules → SSG/SSR
- API Layer for external integration (Spotify)
- Component-based UI, single page application enhanced by server data

##### Putting It All Together

[ User’s Browser ]
|
v
[ CDN / Vercel Edge ] ── serves ──> Static Assets (images, CSS, fonts)
|
v
[ Next.js App Server ]
├─ Loads data modules (data/) and renders Server Components
├─ Exposes API Route /api/np ──> Spotify Web API
└─ Serves React bundles & hydration for Client Components (components/*, hooks/*)
|
v
[ External Spotify API ]

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% User and CDN Layer
    UserBrowser["User’s Browser / Client"]:::frontend
    CDN["CDN / Vercel Edge"]:::static
    UserBrowser -->|"HTTP GET"| CDN

    %% Static Assets served by CDN
    StaticAssets["Static Assets<br/>(images, CSS, fonts)"]:::static
    CDN -->|"serves"| StaticAssets

    %% Next.js Application Layer
    CDN -->|"SSR/SSG Request"| NextApp
    subgraph "Next.js App Server (Serverless Functions)"
        direction TB
        NextApp["Next.js Application"]:::backend

        %% App Router Directory
        AppRouterDir["App Router<br/>(Server & Client Components)"]:::backend
        click AppRouterDir "https://github.com/srummanf/vetrina/tree/main/app/"

        %% Layout and Pages
        RootLayout["Root Layout<br/>(app/layout.tsx)"]:::backend
        click RootLayout "https://github.com/srummanf/vetrina/blob/main/app/layout.tsx"
        HomePage["Home Page<br/>(app/page.tsx)"]:::backend
        click HomePage "https://github.com/srummanf/vetrina/blob/main/app/page.tsx"
        ProjectsPage["Projects Page<br/>(app/projects/page.tsx)"]:::backend
        click ProjectsPage "https://github.com/srummanf/vetrina/blob/main/app/projects/page.tsx"
        LetsMeetPage["Lets-Meet Page<br/>(app/lets-meet/page.tsx)"]:::backend
        click LetsMeetPage "https://github.com/srummanf/vetrina/blob/main/app/lets-meet/page.tsx"
        NotFoundPage["Not-Found Page<br/>(app/not-found.tsx)"]:::backend
        click NotFoundPage "https://github.com/srummanf/vetrina/blob/main/app/not-found.tsx"

        %% API Route
        SpotifyAPIRoute["Spotify Now Playing API Route<br/>(app/api/np/route.ts)"]:::backend
        click SpotifyAPIRoute "https://github.com/srummanf/vetrina/blob/main/app/api/np/route.ts"

        %% UI Components & Hooks
        UIComponents["UI Components Library<br/>(components/)"]:::frontend
        click UIComponents "https://github.com/srummanf/vetrina/tree/main/components/"
        SpotifyNP1["SpotifyNP Component<br/>(components/SpotifyNP.tsx)"]:::frontend
        click SpotifyNP1 "https://github.com/srummanf/vetrina/blob/main/components/SpotifyNP.tsx"
        SpotifyNP2["SpotifyNP2 Component<br/>(components/SpotifyNP2.tsx)"]:::frontend
        click SpotifyNP2 "https://github.com/srummanf/vetrina/blob/main/components/SpotifyNP2.tsx"
        ClickSoundComp["ClickSound Component<br/>(components/ClickSound.tsx)"]:::frontend
        click ClickSoundComp "https://github.com/srummanf/vetrina/blob/main/components/ClickSound.tsx"
        ClientWrapper["ClientWrapper Component<br/>(components/ClientWrapper.tsx)"]:::frontend
        click ClientWrapper "https://github.com/srummanf/vetrina/blob/main/components/ClientWrapper.tsx"
        UseClickHook["useClick Hook<br/>(hooks/useClick.ts)"]:::frontend
        click UseClickHook "https://github.com/srummanf/vetrina/blob/main/hooks/useClick.ts"

        %% Shared Utilities
        Utils["Shared Utilities<br/>(lib/utils.ts)"]:::static
        click Utils "https://github.com/srummanf/vetrina/blob/main/lib/utils.ts"

        %% CSS and Configs
        GlobalCSS["Global CSS<br/>(app/globals.css)"]:::static
        click GlobalCSS "https://github.com/srummanf/vetrina/blob/main/app/globals.css"
        FontCSS["Custom Font CSS<br/>(styles/cabinet-grotesk.css)"]:::static
        click FontCSS "https://github.com/srummanf/vetrina/blob/main/styles/cabinet-grotesk.css"
        NextConfig["Next.js Config<br/>(next.config.ts)"]:::static
        click NextConfig "https://github.com/srummanf/vetrina/blob/main/next.config.ts"
        PostCSS["PostCSS Config<br/>(postcss.config.mjs)"]:::static
        click PostCSS "https://github.com/srummanf/vetrina/blob/main/postcss.config.mjs"

        %% Static Data Modules
        subgraph "Static Data Modules & Assets"
            direction TB
            ProjectsData["projects.ts"]:::static
            click ProjectsData "https://github.com/srummanf/vetrina/blob/main/data/projects.ts"
            LocationData["location.ts"]:::static
            click LocationData "https://github.com/srummanf/vetrina/blob/main/data/location.ts"
            ShayariData["shayari.ts"]:::static
            click ShayariData "https://github.com/srummanf/vetrina/blob/main/data/shayari.ts"
            FontAssets["Font Assets<br/>(font/)"]:::static
            click FontAssets "https://github.com/srummanf/vetrina/tree/main/font/"
            PublicStatic["Public Assets<br/>(public/)"]:::static
            click PublicStatic "https://github.com/srummanf/vetrina/tree/main/public/"
        end
    end

    %% External Service
    SpotifyAPI["Spotify Web API"]:::external

    %% Flow Connections
    NextApp -->|"fetch data modules"| ProjectsData
    NextApp -->|"fetch data modules"| LocationData
    NextApp -->|"fetch data modules"| ShayariData
    NextApp -->|"load utils"| Utils
    NextApp -->|"serves bundles"| UIComponents
    UIComponents -->|uses| ClickSoundComp
    UIComponents -->|uses| ClientWrapper
    ClickSoundComp -->|uses| UseClickHook

    NextApp -->|"GET /api/np"| SpotifyAPIRoute
    SpotifyAPIRoute -->|"HTTP request"| SpotifyAPI
    SpotifyAPI -->|"JSON response"| SpotifyAPIRoute
    SpotifyAPIRoute -->|"return JSON"| UserBrowser

    StaticAssets -->|fetched by| UserBrowser

    classDef frontend fill:#D0E6FF,stroke:#0366d6,color:#0366d6;
    classDef backend fill:#D0FFD6,stroke:#28a745,color:#28a745;
    classDef static fill:#F0F0F0,stroke:#6a737d,color:#6a737d;
    classDef external fill:#FFF4CC,stroke:#d69f08,color:#d69f08;
```
