# henryford-cyber/my-spotify architecture

> Architecture diagram of the GitHub repository henryford-cyber/my-spotify, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-24). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/henryford-cyber/my-spotify
- Repository: https://github.com/henryford-cyber/my-spotify

## Overview

##### Main Architecture Components

a) Frontend Layer:
- Next.js Application (App Router)
- Client-side Components
- Server-side Components
- Client-State Management
- UI Components

b) Backend Layer:
- API Routes
- Authentication System
- Supabase Integration
- Media Storage

##### Detailed Component Breakdown

a) Core Features:
- Authentication (AuthModal, UserProvider)
- Music Player (Player, PlayerContent)
- Library Management
- Search Functionality
- Liked Songs System

b) State Management:
- Custom Hooks Layer
- Provider Components
- Client-side State
- Server-side State

##### Top Level (Client Layer)
**┌─ User Interface Layer ─────────────────────┐**
- ┌─ Components ─┐ ┌─ Pages ──┐ ┌─ Layout ─┐ │
- Sidebar    │ │ - Home   │ │ - Header │ │
- Player    │ │ - Search │ │ - Modal  │ │
- Library   │ │ - Liked  │ │         │ │
- ┘ └──────────┘ └─────────┘ │
- ┘

##### Middle Layer (State & Logic)
**┌─ Application Logic Layer ──────────────────┐**
- ┌─ Hooks ────┐ ┌─ Providers ┐ ┌─ Actions ┐│
- usePlayer  │ │ UserProvider│ │ getSongs ││
- useUser    │ │ ModalProvider│ │ getLiked ││
- ┘ └────────────┘ └─────────┘│
- ┘

##### Bottom Layer (Data & Storage)
**┌─ Data Layer ────────────────────────────┐**
- ┌─ Supabase ─┐ ┌─ Media Storage ─┐     │
- Auth     │ │ - Song Files    │     │
- Database │ │ - Images        │     │
- ┘ └────────────────┘     │
- ┘

##### Important Elements

- Blue: UI Components
- Green: State Management
- Orange: Data Layer
- Purple: Authentication
- Yellow: Media Player

- Data flow between components
- User interaction paths
- State updates
- API calls

##### Specific Implementation Details

Key architectural patterns:

a) Next.js App Router Structure:
- Routing hierarchy (/app directory structure)
- Server vs. client components

b) State Management Flow:
- Custom hooks interaction with UI
- Provider component hierarchy
- Data fetching patterns

c) Authentication Flow:
- Supabase auth integration
- Protected routes
- User session management

##### Technical Stack Indicators

- Next.js
- Supabase
- TypeScript
- Tailwind CSS
- React

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client_Layer
        UI[User Interface]
        UI --> Sidebar["Sidebar"]:::ui
        UI --> Player["Player"]:::player
        UI --> Library["Library"]:::ui
        UI --> Header["Header"]:::ui
        UI --> SearchInput["Search Input"]:::ui
        UI --> AuthModal["Auth Modal"]:::auth
        UI --> UploadModal["Upload Modal"]:::ui
    end

    subgraph Application_Logic
        Hooks[Hooks Layer]
        Hooks --> UsePlayer["usePlayer"]:::state
        Hooks --> UseUser["useUser"]:::state
        Hooks --> UseLoadSong["useLoadSongUrl"]:::state
        Hooks --> UseLoadImage["useLoadImage"]:::state
        Hooks --> UseDebounce["useDebounce"]:::state
        Hooks --> UseAuthModal["useAuthModal"]:::state

        Providers[Provider Layer]
        Providers --> UserProvider["User Provider"]:::state
        Providers --> ModalProvider["Modal Provider"]:::state
        Providers --> SupabaseProvider["Supabase Provider"]:::state
    end

    subgraph Features
        Player --> PlayerContent["Player Content"]:::player
        Library --> MediaItem["Media Item"]:::ui
        Library --> SongItem["Song Item"]:::ui
        
        Search[Search System]
        Search --> SearchContent["Search Content"]:::ui
        
        LikedSongs[Liked Songs System]
        LikedSongs --> LikedContent["Liked Content"]:::ui
        LikedSongs --> LikeButton["Like Button"]:::ui
    end

    subgraph Data_Layer
        Actions[Data Actions]
        Actions --> GetSongs["Get Songs"]:::data
        Actions --> GetSongById["Get Song By Id"]:::data
        Actions --> GetSongsByUser["Get Songs By User"]:::data
        Actions --> GetSongsByTitle["Get Songs By Title"]:::data
        Actions --> GetLikedSongs["Get Liked Songs"]:::data

        Storage[Storage]
        Storage --> SongFiles["Song Files"]:::storage
        Storage --> ImageFiles["Image Files"]:::storage
    end

    %% Relationships
    UI --> Hooks
    UI --> Providers
    Features --> Hooks
    Features --> Actions
    Actions --> Storage

    %% Click Events
    click AuthModal "https://github.com/henryford-cyber/my-spotify/blob/main/components/AuthModal.tsx"
    click UserProvider "https://github.com/henryford-cyber/my-spotify/blob/main/providers/UserProvider.tsx"
    click SupabaseProvider "https://github.com/henryford-cyber/my-spotify/blob/main/providers/SupabaseProviders.tsx"
    click Player "https://github.com/henryford-cyber/my-spotify/blob/main/components/Player.tsx"
    click PlayerContent "https://github.com/henryford-cyber/my-spotify/blob/main/components/PlayerContent.tsx"
    click UsePlayer "https://github.com/henryford-cyber/my-spotify/blob/main/hooks/usePlayer.ts"
    click UseLoadSong "https://github.com/henryford-cyber/my-spotify/blob/main/hooks/useLoadSongUrl.ts"
    click Library "https://github.com/henryford-cyber/my-spotify/blob/main/components/Library.tsx"
    click MediaItem "https://github.com/henryford-cyber/my-spotify/blob/main/components/MediaItem.tsx"
    click SongItem "https://github.com/henryford-cyber/my-spotify/blob/main/components/SongItem.tsx"
    click SearchContent "https://github.com/henryford-cyber/my-spotify/blob/main/app/search/components/SearchContent.tsx"
    click SearchInput "https://github.com/henryford-cyber/my-spotify/blob/main/components/SearchInput.tsx"
    click GetSongsByTitle "https://github.com/henryford-cyber/my-spotify/blob/main/action/getSongsByTitle.ts"
    click UseDebounce "https://github.com/henryford-cyber/my-spotify/blob/main/hooks/useDebounce.ts"
    click LikedContent "https://github.com/henryford-cyber/my-spotify/blob/main/app/liked/components/LikedContent.tsx"
    click LikeButton "https://github.com/henryford-cyber/my-spotify/blob/main/components/LikeButton.tsx"
    click GetLikedSongs "https://github.com/henryford-cyber/my-spotify/blob/main/action/getLikedSongs.ts"
    click ModalProvider "https://github.com/henryford-cyber/my-spotify/blob/main/providers/ModalProvider.tsx"
    click UseAuthModal "https://github.com/henryford-cyber/my-spotify/blob/main/hooks/useAuthModal.tsx"
    click UseUser "https://github.com/henryford-cyber/my-spotify/blob/main/hooks/useUser.tsx"
    click UseLoadImage "https://github.com/henryford-cyber/my-spotify/blob/main/hooks/useLoadImage.tsx"
    click UploadModal "https://github.com/henryford-cyber/my-spotify/blob/main/components/UploadModal.tsx"
    click Sidebar "https://github.com/henryford-cyber/my-spotify/blob/main/components/Sidebar.tsx"
    click Header "https://github.com/henryford-cyber/my-spotify/blob/main/components/Header.tsx"
    click GetSongs "https://github.com/henryford-cyber/my-spotify/blob/main/action/getSongs.ts"
    click GetSongById "https://github.com/henryford-cyber/my-spotify/blob/main/action/getSongById.ts"
    click GetSongsByUser "https://github.com/henryford-cyber/my-spotify/blob/main/action/getSongsByUserId.ts"

    %% Styles
    classDef ui fill:#3498db
    classDef player fill:#f1c40f
    classDef state fill:#2ecc71
    classDef auth fill:#9b59b6
    classDef data fill:#e67e22
    classDef storage fill:#e74c3c

    %% Legend
    subgraph Legend
        UI_Component["UI Component"]:::ui
        Player_Component["Player Component"]:::player
        State_Management["State Management"]:::state
        Auth_Component["Auth Component"]:::auth
        Data_Component["Data Component"]:::data
        Storage_Component["Storage Component"]:::storage
    end
```
