# real-vrajsoni/90s-night architecture

> Architecture diagram of the GitHub repository real-vrajsoni/90s-night, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/real-vrajsoni/90s-night
- Repository: https://github.com/real-vrajsoni/90s-night

## Overview

R’s World is a static listening room: visitors choose Home or a singer, then control YouTube playback through an embedded player. The README documents playlist configuration, singer snapshots, playback-availability checks, saved playback state, live status, and room effects. The map follows those documented relationships; source excerpts were unavailable, so it does not infer additional calls or wiring.

Main entry points: [`assets/js/app.js`](https://github.com/real-vrajsoni/90s-night/blob/main/assets/js/app.js) (Player Behavior), [`index.html`](https://github.com/real-vrajsoni/90s-night/blob/main/index.html) (Listening Room), [`assets/js/effects.js`](https://github.com/real-vrajsoni/90s-night/blob/main/assets/js/effects.js) (Room Interactions), [`assets/js/playlist-snapshots.js`](https://github.com/real-vrajsoni/90s-night/blob/main/assets/js/playlist-snapshots.js) (Playlist Snapshots)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Room Experience"]
  node_page["Listening Room<br/>[index.html]"]
  node_app["Player Behavior<br/>[app.js]"]
  node_effects["Room Interactions<br/>[effects.js]"]
end

subgraph group_playback["Music Playback"]
  node_youtube["YouTube Player"]
  node_snapshots["Playlist Snapshots"]
  node_availability["Playback Checks"]
end

subgraph group_settings["Configuration and State"]
  node_config["Site Configuration<br/>[config.js]"]
  node_browserstate[("Browser-Saved State")]
  node_liveendpoint["Listener Endpoint"]
end

subgraph group_presentation["Visual Presentation"]
  node_style["Room Theme<br/>[style.css]"]
  node_enhancements["Control Styling<br/>[enhancements.css]"]
  node_effectsstyles["3D Styling<br/>[effects.css]"]
  node_shopvideo["Shop Loop<br/>[shop-loop.mp4]"]
end

node_visitor(("Visitor"))
node_instagram["Instagram"]
node_ytmusic["YouTube Music"]

node_visitor -->|"opens"| node_page
node_visitor -->|"controls"| node_app
node_app -->|"loads playlists"| node_youtube
node_app -->|"controls playback"| node_youtube
node_app -->|"uses singer lists"| node_snapshots
node_app -->|"filters queues"| node_availability
node_app -->|"reads settings"| node_config
node_app -->|"saves playback state"| node_browserstate
node_app -.->|"fetches count"| node_liveendpoint
node_app -->|"opens link"| node_instagram
node_app -->|"opens playlist"| node_ytmusic
node_app -->|"shows on Home"| node_shopvideo
node_page -->|"uses theme"| node_style
node_page -->|"uses controls"| node_enhancements
node_page -->|"uses effects"| node_effectsstyles
node_app -->|"supports interactions"| node_effects

click node_page "https://github.com/real-vrajsoni/90s-night/blob/main/index.html"
click node_app "https://github.com/real-vrajsoni/90s-night/blob/main/assets/js/app.js"
click node_effects "https://github.com/real-vrajsoni/90s-night/blob/main/assets/js/effects.js"
click node_snapshots "https://github.com/real-vrajsoni/90s-night/blob/main/assets/js/playlist-snapshots.js"
click node_availability "https://github.com/real-vrajsoni/90s-night/blob/main/assets/js/playback-availability.js"
click node_config "https://github.com/real-vrajsoni/90s-night/blob/main/assets/js/config.js"
click node_style "https://github.com/real-vrajsoni/90s-night/blob/main/assets/css/style.css"
click node_enhancements "https://github.com/real-vrajsoni/90s-night/blob/main/assets/css/enhancements.css"
click node_effectsstyles "https://github.com/real-vrajsoni/90s-night/blob/main/assets/css/effects.css"
click node_shopvideo "https://github.com/real-vrajsoni/90s-night/blob/main/assets/video/shop-loop.mp4"

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_page,node_app,node_effects toneBlue
class node_youtube,node_snapshots,node_availability toneAmber
class node_config,node_browserstate,node_liveendpoint toneMint
class node_style,node_enhancements,node_effectsstyles,node_shopvideo toneRose
class node_visitor,node_instagram,node_ytmusic toneIndigo
```

## Components

### Room Experience

- [Listening Room](https://github.com/real-vrajsoni/90s-night/blob/main/index.html): `index.html`
- [Player Behavior](https://github.com/real-vrajsoni/90s-night/blob/main/assets/js/app.js): `assets/js/app.js`
- [Room Interactions](https://github.com/real-vrajsoni/90s-night/blob/main/assets/js/effects.js): `assets/js/effects.js`

### Music Playback

- **YouTube Player**
- [Playlist Snapshots](https://github.com/real-vrajsoni/90s-night/blob/main/assets/js/playlist-snapshots.js): `assets/js/playlist-snapshots.js`
- [Playback Checks](https://github.com/real-vrajsoni/90s-night/blob/main/assets/js/playback-availability.js): `assets/js/playback-availability.js`

### Configuration and State

- [Site Configuration](https://github.com/real-vrajsoni/90s-night/blob/main/assets/js/config.js): `assets/js/config.js`
- **Browser-Saved State**
- **Listener Endpoint**

### Visual Presentation

- [Room Theme](https://github.com/real-vrajsoni/90s-night/blob/main/assets/css/style.css): `assets/css/style.css`
- [Control Styling](https://github.com/real-vrajsoni/90s-night/blob/main/assets/css/enhancements.css): `assets/css/enhancements.css`
- [3D Styling](https://github.com/real-vrajsoni/90s-night/blob/main/assets/css/effects.css): `assets/css/effects.css`
- [Shop Loop](https://github.com/real-vrajsoni/90s-night/blob/main/assets/video/shop-loop.mp4): `assets/video/shop-loop.mp4`

### Other components

- **Visitor**
- **Instagram**
- **YouTube Music**

## Connections

- Visitor → Listening Room: opens (evidence: `README.md`)
- Visitor → Player Behavior: controls (evidence: `README.md`)
- Player Behavior → YouTube Player: loads playlists (evidence: `README.md`)
- Player Behavior → YouTube Player: controls playback (evidence: `README.md`)
- Player Behavior → Playlist Snapshots: uses singer lists (evidence: `README.md`)
- Player Behavior → Playback Checks: filters queues (evidence: `README.md`)
- Player Behavior → Site Configuration: reads settings (evidence: `README.md`)
- Player Behavior → Browser-Saved State: saves playback state (evidence: `README.md`)
- Player Behavior → Listener Endpoint: fetches count
- Player Behavior → Instagram: opens link (evidence: `README.md`)
- Player Behavior → YouTube Music: opens playlist (evidence: `README.md`)
- Player Behavior → Shop Loop: shows on Home (evidence: `README.md`)
- Listening Room → Room Theme: uses theme (evidence: `README.md`)
- Listening Room → Control Styling: uses controls (evidence: `README.md`)
- Listening Room → 3D Styling: uses effects (evidence: `README.md`)
- Player Behavior → Room Interactions: supports interactions (evidence: `README.md`)
