# marcolb123/freestylin architecture

> Architecture diagram of the GitHub repository marcolb123/freestylin, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/marcolb123/freestylin
- Repository: https://github.com/marcolb123/freestylin

## Overview

Freestyle Dance Prompt App helps dancers choose a style, get a prompt and practice material, train with music and a metronome, and optionally record the session. The app also supports accounts, prompt submissions and moderation, favorites, and engagement analytics. The graph follows the React-to-API-to-MongoDB path and keeps practice timing, media, and journal features distinct. Some backend routes and models are documented but not excerpted; those links are cited to the README rather than presented as inspected implementation details.

Main entry points: [`src/App.jsx`](https://github.com/marcolb123/freestylin/blob/main/src/App.jsx) (App and Routes), [`server.js`](https://github.com/marcolb123/freestylin/blob/main/server.js) (Express API), [`src/practice/PracticePanel.jsx`](https://github.com/marcolb123/freestylin/blob/main/src/practice/PracticePanel.jsx) (Practice Controls), [`prompt-model.js`](https://github.com/marcolb123/freestylin/blob/main/prompt-model.js) (Prompt Model)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Dancer Experience"]
  node_app["App and Routes<br/>[App.jsx]"]
  node_auth["Authentication Context<br/>[auth-context.js]"]
  node_api["API Client<br/>[api.js]"]
  node_journal["Training Journal<br/>[JournalPage.jsx]"]
  node_music["Music Player<br/>[MusicPanel.jsx]"]
  node_musiclinks["Music Link Parser<br/>[music.js]"]
  node_video["Tutorial Embed<br/>[YouTubeEmbed.jsx]"]
  node_videoids["YouTube URL Helpers<br/>[youtube.js]"]
end

subgraph group_practice["Practice Tools"]
  node_practiceprovider["Practice Provider"]
  node_practicepanel["Practice Controls<br/>[PracticePanel.jsx]"]
  node_engine["Metronome Engine"]
  node_scheduler["Beat Scheduler<br/>[scheduler.js]"]
  node_tickworker["Tick Worker<br/>[tick-worker.js]"]
  node_count["Count Display<br/>[CountDisplay.jsx]"]
  node_practicecontext["Practice Contexts"]
end

subgraph group_backend["API and Domain"]
  node_server["Express API<br/>[server.js]"]
  node_promptmodel["Prompt Model<br/>[prompt-model.js]"]
  node_promptservice["Prompt API<br/>[server.js]"]
  node_accountservice["Accounts and Favorites<br/>[server.js]"]
  node_journalservice["Journal API<br/>[server.js]"]
  node_analytics["Admin and Analytics<br/>[server.js]"]
  node_database[("MongoDB")]
end

subgraph group_data["Prompt Data"]
  node_promptdata["Dance Prompt Content<br/>[prompts-data.js]"]
  node_styles["Style Metadata<br/>[styles.js]"]
end

node_dancer(("Dancer"))

node_dancer -->|"uses"| node_app
node_app -->|"uses"| node_auth
node_app -->|"requests data"| node_api
node_app -->|"routes to"| node_journal
node_app -->|"renders"| node_music
node_app -->|"renders"| node_video
node_music -->|"parses links"| node_musiclinks
node_video -->|"extracts IDs"| node_videoids
node_app -->|"wraps routes"| node_practiceprovider
node_practiceprovider -->|"uses engine"| node_engine
node_practiceprovider -->|"provides state"| node_practicecontext
node_app -->|"renders"| node_practicepanel
node_practicepanel -->|"reads state"| node_practicecontext
node_practicepanel -->|"renders"| node_count
node_practicepanel -->|"uses timing"| node_scheduler
node_count -->|"reads beat"| node_practicecontext
node_engine -->|"schedules ticks"| node_scheduler
node_engine -->|"starts worker"| node_tickworker
node_api -->|"sends HTTP requests"| node_server
node_server -->|"uses model"| node_promptmodel
node_server -->|"dispatches routes"| node_promptservice
node_server -->|"dispatches routes"| node_accountservice
node_server -->|"dispatches routes"| node_journalservice
node_server -->|"serves admin stats"| node_analytics
node_promptmodel -->|"stores prompts"| node_database
node_server -->|"uses MongoDB"| node_database
node_promptdata -.->|"supplies prompt records"| node_promptmodel
node_server -->|"validates styles"| node_styles
node_promptmodel -->|"uses style enum"| node_styles
node_music -->|"gets default mix"| node_styles

click node_app "https://github.com/marcolb123/freestylin/blob/main/src/App.jsx"
click node_auth "https://github.com/marcolb123/freestylin/blob/main/src/auth-context.js"
click node_api "https://github.com/marcolb123/freestylin/blob/main/src/api.js"
click node_journal "https://github.com/marcolb123/freestylin/blob/main/src/JournalPage.jsx"
click node_music "https://github.com/marcolb123/freestylin/blob/main/src/components/MusicPanel.jsx"
click node_musiclinks "https://github.com/marcolb123/freestylin/blob/main/src/music.js"
click node_video "https://github.com/marcolb123/freestylin/blob/main/src/components/YouTubeEmbed.jsx"
click node_videoids "https://github.com/marcolb123/freestylin/blob/main/src/youtube.js"
click node_practiceprovider "https://github.com/marcolb123/freestylin/blob/main/src/practice/PracticeProvider.jsx"
click node_practicepanel "https://github.com/marcolb123/freestylin/blob/main/src/practice/PracticePanel.jsx"
click node_engine "https://github.com/marcolb123/freestylin/blob/main/src/practice/usePracticeEngine.js"
click node_scheduler "https://github.com/marcolb123/freestylin/blob/main/src/practice/scheduler.js"
click node_tickworker "https://github.com/marcolb123/freestylin/blob/main/src/practice/tick-worker.js"
click node_count "https://github.com/marcolb123/freestylin/blob/main/src/practice/CountDisplay.jsx"
click node_practicecontext "https://github.com/marcolb123/freestylin/blob/main/src/practice/practice-context.js"
click node_server "https://github.com/marcolb123/freestylin/blob/main/server.js"
click node_promptmodel "https://github.com/marcolb123/freestylin/blob/main/prompt-model.js"
click node_promptservice "https://github.com/marcolb123/freestylin/blob/main/server.js"
click node_accountservice "https://github.com/marcolb123/freestylin/blob/main/server.js"
click node_journalservice "https://github.com/marcolb123/freestylin/blob/main/server.js"
click node_analytics "https://github.com/marcolb123/freestylin/blob/main/server.js"
click node_promptdata "https://github.com/marcolb123/freestylin/blob/main/prompts-data.js"
click node_styles "https://github.com/marcolb123/freestylin/blob/main/styles.js"

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_app,node_auth,node_api,node_journal,node_music,node_musiclinks,node_video,node_videoids toneBlue
class node_practiceprovider,node_practicepanel,node_engine,node_scheduler,node_tickworker,node_count,node_practicecontext toneAmber
class node_server,node_promptmodel,node_promptservice,node_accountservice,node_journalservice,node_analytics,node_database toneMint
class node_promptdata,node_styles toneRose
class node_dancer toneIndigo
```

## Components

### Dancer Experience

- [App and Routes](https://github.com/marcolb123/freestylin/blob/main/src/App.jsx): `src/App.jsx`
- [Authentication Context](https://github.com/marcolb123/freestylin/blob/main/src/auth-context.js): `src/auth-context.js`
- [API Client](https://github.com/marcolb123/freestylin/blob/main/src/api.js): `src/api.js`
- [Training Journal](https://github.com/marcolb123/freestylin/blob/main/src/JournalPage.jsx): `src/JournalPage.jsx`
- [Music Player](https://github.com/marcolb123/freestylin/blob/main/src/components/MusicPanel.jsx): `src/components/MusicPanel.jsx`
- [Music Link Parser](https://github.com/marcolb123/freestylin/blob/main/src/music.js): `src/music.js`
- [Tutorial Embed](https://github.com/marcolb123/freestylin/blob/main/src/components/YouTubeEmbed.jsx): `src/components/YouTubeEmbed.jsx`
- [YouTube URL Helpers](https://github.com/marcolb123/freestylin/blob/main/src/youtube.js): `src/youtube.js`

### Practice Tools

- [Practice Provider](https://github.com/marcolb123/freestylin/blob/main/src/practice/PracticeProvider.jsx): `src/practice/PracticeProvider.jsx`
- [Practice Controls](https://github.com/marcolb123/freestylin/blob/main/src/practice/PracticePanel.jsx): `src/practice/PracticePanel.jsx`
- [Metronome Engine](https://github.com/marcolb123/freestylin/blob/main/src/practice/usePracticeEngine.js): `src/practice/usePracticeEngine.js`
- [Beat Scheduler](https://github.com/marcolb123/freestylin/blob/main/src/practice/scheduler.js): `src/practice/scheduler.js`
- [Tick Worker](https://github.com/marcolb123/freestylin/blob/main/src/practice/tick-worker.js): `src/practice/tick-worker.js`
- [Count Display](https://github.com/marcolb123/freestylin/blob/main/src/practice/CountDisplay.jsx): `src/practice/CountDisplay.jsx`
- [Practice Contexts](https://github.com/marcolb123/freestylin/blob/main/src/practice/practice-context.js): `src/practice/practice-context.js`

### API and Domain

- [Express API](https://github.com/marcolb123/freestylin/blob/main/server.js): `server.js`
- [Prompt Model](https://github.com/marcolb123/freestylin/blob/main/prompt-model.js): `prompt-model.js`
- [Prompt API](https://github.com/marcolb123/freestylin/blob/main/server.js): `server.js`
- [Accounts and Favorites](https://github.com/marcolb123/freestylin/blob/main/server.js): `server.js`
- [Journal API](https://github.com/marcolb123/freestylin/blob/main/server.js): `server.js`
- [Admin and Analytics](https://github.com/marcolb123/freestylin/blob/main/server.js): `server.js`
- **MongoDB**

### Prompt Data

- [Dance Prompt Content](https://github.com/marcolb123/freestylin/blob/main/prompts-data.js): `prompts-data.js`
- [Style Metadata](https://github.com/marcolb123/freestylin/blob/main/styles.js): `styles.js`

### Other components

- **Dancer**

## Connections

- Dancer → App and Routes: uses (evidence: `README.md`)
- App and Routes → Authentication Context: uses (evidence: `src/App.jsx`)
- App and Routes → API Client: requests data (evidence: `src/App.jsx`)
- App and Routes → Training Journal: routes to (evidence: `src/App.jsx`)
- App and Routes → Music Player: renders (evidence: `src/App.jsx`)
- App and Routes → Tutorial Embed: renders (evidence: `src/App.jsx`)
- Music Player → Music Link Parser: parses links (evidence: `src/components/MusicPanel.jsx`)
- Tutorial Embed → YouTube URL Helpers: extracts IDs (evidence: `src/components/YouTubeEmbed.jsx`)
- App and Routes → Practice Provider: wraps routes (evidence: `src/App.jsx`)
- Practice Provider → Metronome Engine: uses engine (evidence: `src/practice/PracticeProvider.jsx`)
- Practice Provider → Practice Contexts: provides state (evidence: `src/practice/PracticeProvider.jsx`)
- App and Routes → Practice Controls: renders (evidence: `src/App.jsx`)
- Practice Controls → Practice Contexts: reads state (evidence: `src/practice/PracticePanel.jsx`)
- Practice Controls → Count Display: renders (evidence: `src/practice/PracticePanel.jsx`)
- Practice Controls → Beat Scheduler: uses timing (evidence: `src/practice/PracticePanel.jsx`)
- Count Display → Practice Contexts: reads beat (evidence: `src/practice/CountDisplay.jsx`)
- Metronome Engine → Beat Scheduler: schedules ticks (evidence: `src/practice/usePracticeEngine.js`)
- Metronome Engine → Tick Worker: starts worker (evidence: `src/practice/usePracticeEngine.js`)
- API Client → Express API: sends HTTP requests (evidence: `README.md`)
- Express API → Prompt Model: uses model (evidence: `server.js`)
- Express API → Prompt API: dispatches routes (evidence: `server.js`)
- Express API → Accounts and Favorites: dispatches routes (evidence: `README.md`)
- Express API → Journal API: dispatches routes (evidence: `README.md`)
- Express API → Admin and Analytics: serves admin stats (evidence: `server.js`)
- Prompt Model → MongoDB: stores prompts (evidence: `README.md`)
- Express API → MongoDB: uses MongoDB (evidence: `README.md`)
- Dance Prompt Content → Prompt Model: supplies prompt records (evidence: `README.md`)
- Express API → Style Metadata: validates styles (evidence: `server.js`)
- Prompt Model → Style Metadata: uses style enum (evidence: `prompt-model.js`)
- Music Player → Style Metadata: gets default mix (evidence: `src/components/MusicPanel.jsx`)
