# ony-boom/mms architecture

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

- Interactive diagram: https://gitdiagram.com/ony-boom/mms
- Repository: https://github.com/ony-boom/mms

## Overview

##### Project type and purpose
- This is a full-stack monorepo called “MMS – My Music Server.”
- Purpose: Provide a web-based local music player. A React client streams and controls audio, while a TypeScript/Nitro server manages the music library, serves files, metadata, and proxies lyrics or cover art.

##### File structure
- Top-level directories:
- apps/client – React frontend
- apps/server – Nitro/TypeScript backend + Prisma migrations + music-manager library
- packages – shared utilities, config and CLI scripts
- Monorepo orchestrated by Turborepo (turbo.json) and pnpm workspace (pnpm-workspace.yaml).
- Client:
- src/api (GraphQL + REST adapters, wiki)
- src/components, src/hooks, src/context, src/stores, src/pages, src/lib, src/styles
- Bundler: Vite (vite.config.ts)
- Server:
- lib/music-manager (file watcher, track saver)
- prisma (SQLite schema + migrations)
- server/api (route definitions under server/api/…)
- server/plugins (dbInit, musicDirWatcher)
- middleware (CORS)
- Nitro config, tsconfig, .env.example
- packages: share TypeScript and ESLint configs and custom CLI tools.

##### README insights
- Describes a client-server architecture.
- Tech stack: TypeScript, React, SQLite via Prisma, pnpm, Turborepo, Nix support.
- Emphasis on local music playback, search, playlists (work in progress), modern UI.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Frontend Layer
    subgraph "Frontend Layer"
        direction TB
        Browser["Browser (React App)"]:::frontend
        ClientAPI["API Layer\n(GraphQL & REST adapters)"]:::frontend
        WikiAdapter["Wiki Adapter\n(Wikipedia API)"]:::frontend
    end

    %% Backend Layer
    subgraph "Backend Layer"
        direction TB
        NitroServer["Nitro Server\n(config & entry)"]:::backend
        RouteDefs["Route Definitions\n(server/api)"]:::backend
        TracksGroup["Tracks Endpoints\n(server/api/tracks)"]:::backend
        SSELoader["SSE Loader\n(/tracks/load/sse)"]:::backend
        CoverProxy["Cover Art Proxy\n(fromDeezer)"]:::backend
        LyricsProxy["Lyrics Proxy\n(/lyrics)"]:::backend
        MusicManager["Music-Manager Library"]:::backend
        FileSystem["Local File System\n(music directory)"]:::backend
        PrismaClient["Prisma Client"]:::backend
        SQLiteDB["SQLite Database"]:::database
        DBInit["DB Init Plugin"]:::backend
        Watcher["Music Directory Watcher Plugin"]:::backend
    end

    %% Shared Layer
    subgraph "Shared Packages"
        direction TB
        SharedCLI["Shared CLI Tools"]:::shared
        TSConfig["Shared TypeScript Config"]:::shared
        ESLintConfig["Shared ESLint Config"]:::shared
    end

    %% Orchestration
    subgraph "Monorepo Orchestration"
        direction TB
        Turbo["Turborepo\n(turbo.json)"]:::infra
        Pnpm["pnpm Workspace\n(pnpm-workspace.yaml)"]:::infra
    end

    %% Connections Frontend
    Browser -->|"HTTP/S"| ClientAPI
    ClientAPI -->|"Wiki Calls"| WikiAdapter
    ClientAPI -->|"API Requests"| NitroServer

    %% Connections Backend
    NitroServer -->|"routes load"| RouteDefs
    RouteDefs --> TracksGroup
    TracksGroup --> SSELoader
    RouteDefs --> CoverProxy
    RouteDefs --> LyricsProxy
    RouteDefs -->|"uses ORM"| PrismaClient
    PrismaClient --> SQLiteDB
    NitroServer --> MusicManager
    MusicManager --> FileSystem
    NitroServer --> DBInit
    NitroServer --> Watcher

    %% Connections Shared
    SharedCLI --> NitroServer
    SharedCLI --> ClientAPI
    TSConfig --> NitroServer
    TSConfig --> ClientAPI
    ESLintConfig --> NitroServer
    ESLintConfig --> ClientAPI

    %% Orchestration links
    Turbo --> SharedCLI
    Turbo --> NitroServer
    Turbo --> ClientAPI
    Pnpm --> SharedCLI
    Pnpm --> NitroServer
    Pnpm --> ClientAPI

    %% Click Events
    click Browser "https://github.com/ony-boom/mms/tree/main/apps/client"
    click ClientAPI "https://github.com/ony-boom/mms/tree/main/apps/client/src/api"
    click WikiAdapter "https://github.com/ony-boom/mms/tree/main/apps/client/src/api/wiki"
    click NitroServer "https://github.com/ony-boom/mms/blob/main/apps/server/nitro.config.ts"
    click RouteDefs "https://github.com/ony-boom/mms/tree/main/apps/server/server/api"
    click CoverProxy "https://github.com/ony-boom/mms/blob/main/apps/server/server/api/cover/fromDeezer/[artistName].get.ts"
    click LyricsProxy "https://github.com/ony-boom/mms/blob/main/apps/server/server/api/lyrics/[trackId].get.ts"
    click TracksGroup "https://github.com/ony-boom/mms/tree/main/apps/server/server/api/tracks"
    click SSELoader "https://github.com/ony-boom/mms/blob/main/apps/server/server/api/tracks/load/sse.ts"
    click MusicManager "https://github.com/ony-boom/mms/tree/main/apps/server/lib/music-manager"
    click DBInit "https://github.com/ony-boom/mms/blob/main/apps/server/server/plugins/dbInit.ts"
    click Watcher "https://github.com/ony-boom/mms/blob/main/apps/server/server/plugins/musicDirWatcher.ts"
    click SQLiteDB "https://github.com/ony-boom/mms/blob/main/apps/server/prisma/schema.prisma"
    click SharedCLI "https://github.com/ony-boom/mms/tree/main/packages/bin"
    click TSConfig "https://github.com/ony-boom/mms/tree/main/packages/typescript-config"
    click ESLintConfig "https://github.com/ony-boom/mms/tree/main/packages/eslint-config"
    click Turbo "https://github.com/ony-boom/mms/blob/main/turbo.json"
    click Pnpm "https://github.com/ony-boom/mms/blob/main/pnpm-workspace.yaml"

    %% Styles
    classDef frontend fill:#ccffcc,stroke:#333,stroke-width:1px;
    classDef backend fill:#cce5ff,stroke:#333,stroke-width:1px;
    classDef shared fill:#fff2cc,stroke:#333,stroke-width:1px;
    classDef infra fill:#e2e2e2,stroke:#333,stroke-width:1px;
    classDef database fill:#ffd1dc,stroke:#333,stroke-width:1px,shape:cylinder;
```
