# katjpg/90s-wrapped architecture

> Architecture diagram of the GitHub repository katjpg/90s-wrapped, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/katjpg/90s-wrapped
- Repository: https://github.com/katjpg/90s-wrapped

## Overview

##### Main Components Identification

a) Client-Side Layer
- Next.js Frontend (App Router)
- Component Structure
- Static Assets

b) Build & Configuration Layer
- Next.js Build System
- TypeScript Configuration
- Styling System (Tailwind CSS)

**┌─────────────────────────────────────────────┐**
- Next.js App                   │

- ┌─────────────┐  ┌────────────────────┐   │
- Layout    │  │      Pages         │   │
- (Root)     │  │  - Home (/)        │   │
- ┘  │  - Wrapped (/wrapped│   │
- ┘   │

- ┌─────────────────────────────────────┐   │
- Components                 │   │
- ┌─────────┐ ┌─────────┐ ┌────────┐│   │
- About   │ │TopArtists│ │TopHits ││   │
- ┘ └─────────┘ └────────┘│   │
- ┌─────────┐ ┌─────────┐ ┌────────┐│   │
- UserStats│ │ TopAlbums│ │  ...   ││   │
- ┘ └─────────┘ └────────┘│   │
- ┘   │

- ┌─────────────────────────────────────┐   │
- Hooks                   │   │
- useTypingSound              │   │
- ┘   │
- ┘

##### Component Relationships

- Parent-child relationships between components
- Data flow between components
- Hook usage across components

##### Technical Stack Indicators

- Next.js
- TypeScript
- Tailwind CSS
- ESLint

##### Additional Notes

- App router structure (/app directory)
- How global styles (globals.css) affect the entire application
- Where type definitions are used (TypeScript)

Remember to include version information for major dependencies and note any significant architectural decisions that might not be immediately apparent from the file structure alone.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph NextApp["Next.js Application"]
        subgraph FrontendLayer["Frontend Layer"]
            Layout["Root Layout"]
            Pages["Pages Container"]
            Home["Home Page"]
            Wrapped["Wrapped Page"]
            
            Pages --> Home
            Pages --> Wrapped
            Layout --> Pages
        end

        subgraph ComponentLayer["Component Layer"]
            About["About"]
            TopArtists["Top Artists"]
            TopHits["Top Hits"]
            UserStats["User Stats"]
            TopAlbums["Top Albums"]
            ArtistQuiz["Artist Quiz"]
            
            Home --> About
            Home --> TopArtists
            Home --> TopHits
            Home --> UserStats
            Home --> TopAlbums
            Home --> ArtistQuiz
        end

        subgraph UtilityLayer["Utility Layer"]
            Hooks["Hooks System"]
            useTypingSound["useTypingSound"]
            
            Hooks --> useTypingSound
            ComponentLayer --> Hooks
        end

        subgraph ConfigLayer["Configuration Layer"]
            NextConfig["Next.js Config"]
            TSConfig["TypeScript Config"]
            TailwindConfig["Tailwind Config"]
            GlobalStyles["Global Styles"]
            StaticAssets["Static Assets"]
        end
    end

    classDef default fill:#f9f9f9,stroke:#333,stroke-width:1px
    classDef layout fill:#4299e1,color:white
    classDef page fill:#63b3ed,color:white
    classDef component fill:#48bb78,color:white
    classDef utility fill:#9f7aea,color:white
    classDef config fill:#718096,color:white

    class Layout,Pages layout
    class Home,Wrapped page
    class About,TopArtists,TopHits,UserStats,TopAlbums,ArtistQuiz component
    class Hooks,useTypingSound utility
    class NextConfig,TSConfig,TailwindConfig,GlobalStyles,StaticAssets config

    click Layout "https://github.com/katjpg/90s-wrapped/blob/main/src/app/layout.tsx"
    click Home "https://github.com/katjpg/90s-wrapped/blob/main/src/app/page.tsx"
    click Wrapped "https://github.com/katjpg/90s-wrapped/blob/main/src/app/pages/wrapped/page.tsx"
    click About "https://github.com/katjpg/90s-wrapped/blob/main/src/app/components/About.tsx"
    click TopArtists "https://github.com/katjpg/90s-wrapped/blob/main/src/app/components/TopArtists.tsx"
    click TopHits "https://github.com/katjpg/90s-wrapped/blob/main/src/app/components/TopHits.tsx"
    click UserStats "https://github.com/katjpg/90s-wrapped/blob/main/src/app/components/UserStats.tsx"
    click TopAlbums "https://github.com/katjpg/90s-wrapped/blob/main/src/app/components/TopAlbums.tsx"
    click ArtistQuiz "https://github.com/katjpg/90s-wrapped/blob/main/src/app/components/ArtistQuiz.tsx"
    click useTypingSound "https://github.com/katjpg/90s-wrapped/blob/main/src/app/hooks/useTypingSound.ts"
    click GlobalStyles "https://github.com/katjpg/90s-wrapped/blob/main/src/app/globals.css"
    click TSConfig "https://github.com/katjpg/90s-wrapped/blob/main/tsconfig.json"
    click NextConfig "https://github.com/katjpg/90s-wrapped/blob/main/next.config.ts"
    click TailwindConfig "https://github.com/katjpg/90s-wrapped/blob/main/tailwind.config.ts"
    click StaticAssets "https://github.com/katjpg/90s-wrapped/tree/main/public"
```
