# ronalddeng/rhine-music-demo architecture

> Architecture diagram of the GitHub repository ronalddeng/rhine-music-demo, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ronalddeng/rhine-music-demo
- Repository: https://github.com/ronalddeng/rhine-music-demo

## Overview

Rhine Music Demo is a browser-based local music library: users configure and scan a local folder, browse the resulting albums in a 3D archive, open an album, search or select a track, and play it in-browser. The graph preserves documented scanning, metadata enrichment, playback, presentation, and preference capabilities. Source excerpts clarify the front-end entry point and major rendering/data dependencies; service-internal arrows are limited where implementation was not sampled.

Main entry points: [`src/music-app.ts`](https://github.com/ronalddeng/rhine-music-demo/blob/main/src/music-app.ts) (Music application), [`scripts/music-server.mjs`](https://github.com/ronalddeng/rhine-music-demo/blob/main/scripts/music-server.mjs) (Music service), [`scripts/music-library.mjs`](https://github.com/ronalddeng/rhine-music-demo/blob/main/scripts/music-library.mjs) (Library scan and metadata), [`src/scene.ts`](https://github.com/ronalddeng/rhine-music-demo/blob/main/src/scene.ts) (3D archive scene)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_library["Library service"]
  node_musicserver["Music service<br/>[music-server.mjs]"]
  node_libraryscan["Library scan and metadata<br/>[music-library.mjs]"]
  node_albumenrichment["Album enrichment"]
  node_musictype["Library data contract<br/>[music-types.ts]"]
end

subgraph group_browse["Album browsing"]
  node_appentry["Mode entry<br/>[main.ts]"]
  node_musicapp["Music application<br/>[music-app.ts]"]
  node_albumdata["Album view data<br/>[data.ts]"]
  node_archiveflow["Archive navigation<br/>[archive-loop.ts]"]
  node_archiveview["3D archive scene<br/>[scene.ts]"]
  node_albummodel["3D album model<br/>[music-model.ts]"]
end

subgraph group_playback["Music playback"]
  node_player["Track player<br/>[music-player.ts]"]
  node_audio["Audio and sound<br/>[audio.ts]"]
end

subgraph group_experience["Presentation and settings"]
  node_renderquality["Render quality<br/>[render-quality.ts]"]
  node_qualitysettings["Quality settings"]
  node_viewport["Responsive layout<br/>[viewport-layout.ts]"]
  node_motion["Motion transitions<br/>[motion.ts]"]
  node_pwa["Offline app support<br/>[pwa.ts]"]
end

node_user(("Listener"))
node_browser(("Web browser"))
node_localmusic[("Local music files")]

node_user -->|"uses"| node_browser
node_user -->|"selects folder"| node_localmusic
node_browser -->|"loads"| node_appentry
node_appentry -->|"loads music mode"| node_musicapp
node_browser -.->|"requests library"| node_musicserver
node_musicserver -.->|"dispatches scan"| node_libraryscan
node_libraryscan -->|"reads metadata"| node_localmusic
node_libraryscan -->|"produces records"| node_musictype
node_musicserver -.->|"offers enrichment"| node_albumenrichment
node_albumenrichment -.->|"updates album data"| node_musictype
node_musicapp -.->|"loads library"| node_musicserver
node_musicapp -->|"sets albums"| node_albumdata
node_albumdata -->|"supplies columns"| node_archiveflow
node_musicapp -->|"selects albums"| node_archiveflow
node_musicapp -->|"creates scene"| node_archiveview
node_archiveview -->|"loads model"| node_albummodel
node_archiveview -->|"renders with"| node_renderquality
node_musicapp -->|"configures"| node_qualitysettings
node_qualitysettings -->|"normalizes settings"| node_renderquality
node_musicapp -->|"adapts layout"| node_viewport
node_user -->|"starts track"| node_player
node_musicapp -.->|"controls playback"| node_player
node_player -->|"reads audio"| node_localmusic
node_musicapp -.->|"plays interface sounds"| node_audio
node_musicapp -.->|"animates navigation"| node_motion
node_musicapp -.->|"initializes"| node_pwa
node_user -->|"requests lookup"| node_albumenrichment

click node_musicserver "https://github.com/ronalddeng/rhine-music-demo/blob/main/scripts/music-server.mjs"
click node_libraryscan "https://github.com/ronalddeng/rhine-music-demo/blob/main/scripts/music-library.mjs"
click node_albumenrichment "https://github.com/ronalddeng/rhine-music-demo/blob/main/scripts/album-introductions.mjs"
click node_musictype "https://github.com/ronalddeng/rhine-music-demo/blob/main/src/music-types.ts"
click node_appentry "https://github.com/ronalddeng/rhine-music-demo/blob/main/src/main.ts"
click node_musicapp "https://github.com/ronalddeng/rhine-music-demo/blob/main/src/music-app.ts"
click node_albumdata "https://github.com/ronalddeng/rhine-music-demo/blob/main/src/data.ts"
click node_archiveflow "https://github.com/ronalddeng/rhine-music-demo/blob/main/src/archive-loop.ts"
click node_archiveview "https://github.com/ronalddeng/rhine-music-demo/blob/main/src/scene.ts"
click node_albummodel "https://github.com/ronalddeng/rhine-music-demo/blob/main/src/music-model.ts"
click node_renderquality "https://github.com/ronalddeng/rhine-music-demo/blob/main/src/render-quality.ts"
click node_qualitysettings "https://github.com/ronalddeng/rhine-music-demo/blob/main/src/quality-settings.ts"
click node_viewport "https://github.com/ronalddeng/rhine-music-demo/blob/main/src/viewport-layout.ts"
click node_motion "https://github.com/ronalddeng/rhine-music-demo/blob/main/src/motion.ts"
click node_player "https://github.com/ronalddeng/rhine-music-demo/blob/main/src/music-player.ts"
click node_audio "https://github.com/ronalddeng/rhine-music-demo/blob/main/src/audio.ts"
click node_pwa "https://github.com/ronalddeng/rhine-music-demo/blob/main/src/pwa.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_musicserver,node_libraryscan,node_albumenrichment,node_musictype,node_browser toneBlue
class node_appentry,node_musicapp,node_albumdata,node_archiveflow,node_archiveview,node_albummodel,node_localmusic toneAmber
class node_player,node_audio toneMint
class node_renderquality,node_qualitysettings,node_viewport,node_motion,node_pwa toneRose
class node_user toneIndigo
```

## Components

### Library service

- [Music service](https://github.com/ronalddeng/rhine-music-demo/blob/main/scripts/music-server.mjs): `scripts/music-server.mjs`
- [Library scan and metadata](https://github.com/ronalddeng/rhine-music-demo/blob/main/scripts/music-library.mjs): `scripts/music-library.mjs`
- [Album enrichment](https://github.com/ronalddeng/rhine-music-demo/blob/main/scripts/album-introductions.mjs): `scripts/album-introductions.mjs`
- [Library data contract](https://github.com/ronalddeng/rhine-music-demo/blob/main/src/music-types.ts): `src/music-types.ts`

### Album browsing

- [Mode entry](https://github.com/ronalddeng/rhine-music-demo/blob/main/src/main.ts): `src/main.ts`
- [Music application](https://github.com/ronalddeng/rhine-music-demo/blob/main/src/music-app.ts): `src/music-app.ts`
- [Album view data](https://github.com/ronalddeng/rhine-music-demo/blob/main/src/data.ts): `src/data.ts`
- [Archive navigation](https://github.com/ronalddeng/rhine-music-demo/blob/main/src/archive-loop.ts): `src/archive-loop.ts`
- [3D archive scene](https://github.com/ronalddeng/rhine-music-demo/blob/main/src/scene.ts): `src/scene.ts`
- [3D album model](https://github.com/ronalddeng/rhine-music-demo/blob/main/src/music-model.ts): `src/music-model.ts`

### Music playback

- [Track player](https://github.com/ronalddeng/rhine-music-demo/blob/main/src/music-player.ts): `src/music-player.ts`
- [Audio and sound](https://github.com/ronalddeng/rhine-music-demo/blob/main/src/audio.ts): `src/audio.ts`

### Presentation and settings

- [Render quality](https://github.com/ronalddeng/rhine-music-demo/blob/main/src/render-quality.ts): `src/render-quality.ts`
- [Quality settings](https://github.com/ronalddeng/rhine-music-demo/blob/main/src/quality-settings.ts): `src/quality-settings.ts`
- [Responsive layout](https://github.com/ronalddeng/rhine-music-demo/blob/main/src/viewport-layout.ts): `src/viewport-layout.ts`
- [Motion transitions](https://github.com/ronalddeng/rhine-music-demo/blob/main/src/motion.ts): `src/motion.ts`
- [Offline app support](https://github.com/ronalddeng/rhine-music-demo/blob/main/src/pwa.ts): `src/pwa.ts`

### Other components

- **Listener**
- **Web browser**
- **Local music files**

## Connections

- Listener → Web browser: uses (evidence: `README.md`)
- Listener → Local music files: selects folder (evidence: `README.md`)
- Web browser → Mode entry: loads (evidence: `src/main.ts`)
- Mode entry → Music application: loads music mode (evidence: `src/main.ts`)
- Web browser → Music service: requests library
- Music service → Library scan and metadata: dispatches scan
- Library scan and metadata → Local music files: reads metadata (evidence: `README.md`)
- Library scan and metadata → Library data contract: produces records (evidence: `src/music-types.ts`)
- Music service → Album enrichment: offers enrichment
- Album enrichment → Library data contract: updates album data
- Music application → Music service: loads library
- Music application → Album view data: sets albums (evidence: `src/data.ts`)
- Album view data → Archive navigation: supplies columns (evidence: `src/archive-loop.ts`)
- Music application → Archive navigation: selects albums (evidence: `src/music-app.ts`)
- Music application → 3D archive scene: creates scene (evidence: `src/music-app.ts`)
- 3D archive scene → 3D album model: loads model (evidence: `src/scene.ts`)
- 3D archive scene → Render quality: renders with (evidence: `src/scene.ts`)
- Music application → Quality settings: configures (evidence: `src/music-app.ts`)
- Quality settings → Render quality: normalizes settings (evidence: `src/quality-settings.ts`)
- Music application → Responsive layout: adapts layout (evidence: `src/music-app.ts`)
- Listener → Track player: starts track (evidence: `README.md`)
- Music application → Track player: controls playback (evidence: `src/music-app.ts`)
- Track player → Local music files: reads audio (evidence: `README.md`)
- Music application → Audio and sound: plays interface sounds (evidence: `src/music-app.ts`)
- Music application → Motion transitions: animates navigation
- Music application → Offline app support: initializes
- Listener → Album enrichment: requests lookup (evidence: `README.md`)
