# aaron-burr-web/musiclab architecture

> Architecture diagram of the GitHub repository aaron-burr-web/musiclab, 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/aaron-burr-web/musiclab
- Repository: https://github.com/aaron-burr-web/musiclab

## Overview

MusicLab is a static, browser-based music-learning and DAW-style creation site. Learners move from tutorial pages and interactive demonstrations to chapter quizzes and locally recorded progress; they can also practice pitch and ear training, then compose with the Playground sequencer. The map preserves documented learning, account, settings, and support capabilities. Relationships rely on README descriptions or the shown source excerpts; several page-to-script bindings and unsampled modules are not visible, so those links are omitted rather than inferred.

Main entry points: [`Start Learning`](https://github.com/aaron-burr-web/musiclab/tree/main/Start%20Learning) (Lesson pages), [`login`](https://github.com/aaron-burr-web/musiclab/tree/main/login) (Login and registration), [`js/audio-engine.js`](https://github.com/aaron-burr-web/musiclab/blob/main/js/audio-engine.js) (Audio engine), [`js/beat-demo.js`](https://github.com/aaron-burr-web/musiclab/blob/main/js/beat-demo.js) (Beat demonstrations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Lessons and practice"]
  node_lesson_pages["Lesson pages"]
  node_beat_demo["Beat demonstrations<br/>[beat-demo.js]"]
  node_chord_learning["Chord exercises<br/>[chords-learning.js]"]
  node_pitch_learning["Pitch lessons<br/>[pitch-learning.js]"]
  node_melody_learning["Melody lessons<br/>[pitch-melodies.js]"]
  node_notation_learning["Notation lessons<br/>[pitch-notation.js]"]
  node_ear_training["Ear training<br/>[ear-training.js]"]
  node_lesson_quiz["Lesson quizzes<br/>[lesson-quiz.js]"]
  node_practice_keyboard["Practice keyboard"]
end

subgraph group_creation["Music creation and audio"]
  node_playground["Playground sequencer"]
  node_track_demo["Four-track demo<br/>[track-demo.js]"]
  node_audio_engine["Audio engine<br/>[audio-engine.js]"]
  node_audio_samples[("Audio samples")]
end

subgraph group_platform["Shared platform"]
  node_shared_ui["Shared UI and state<br/>[musiclab-ui.js]"]
  node_profile_storage[("Browser-local records<br/>[musiclab-ui.js]")]
  node_qa["Learner questionnaire<br/>[QA.js]"]
end

subgraph group_account["Accounts and support"]
  node_account_pages["Login and registration"]
  node_login_logic["Account handling<br/>[login.js]"]
  node_terms["Service terms<br/>[terms.js]"]
  node_contact_page["Contact and feedback<br/>[contact.html]"]
  node_settings_page["Settings<br/>[settings.html]"]
end

node_learner(("Learner"))

node_learner -->|"opens lessons"| node_lesson_pages
node_lesson_pages -->|"offers demonstrations"| node_beat_demo
node_lesson_pages -->|"offers exercises"| node_chord_learning
node_lesson_pages -->|"teaches pitch"| node_pitch_learning
node_lesson_pages -->|"teaches melodies"| node_melody_learning
node_lesson_pages -->|"teaches notation"| node_notation_learning
node_lesson_pages -->|"offers listening practice"| node_ear_training
node_lesson_pages -->|"hosts chapter quizzes"| node_lesson_quiz
node_lesson_quiz -->|"uses progress API"| node_shared_ui
node_shared_ui -->|"stores local progress"| node_profile_storage
node_learner -->|"creates music"| node_playground
node_learner -->|"practices notes"| node_practice_keyboard
node_learner -->|"tries track combinations"| node_track_demo
node_playground -->|"uses shared audio"| node_audio_engine
node_beat_demo -->|"plays samples"| node_audio_samples
node_ear_training -->|"plays notes"| node_audio_engine
node_chord_learning -->|"plays chords"| node_audio_engine
node_learner -->|"answers questionnaire"| node_qa
node_learner -->|"registers or logs in"| node_account_pages
node_account_pages -->|"submits account forms"| node_login_logic
node_login_logic -->|"stores account locally"| node_profile_storage
node_learner -->|"manages preferences"| node_settings_page
node_learner -->|"sends feedback"| node_contact_page
node_account_pages -->|"opens terms"| node_terms

click node_lesson_pages "https://github.com/aaron-burr-web/musiclab/tree/main/Start%20Learning"
click node_beat_demo "https://github.com/aaron-burr-web/musiclab/blob/main/js/beat-demo.js"
click node_chord_learning "https://github.com/aaron-burr-web/musiclab/blob/main/js/chords-learning.js"
click node_pitch_learning "https://github.com/aaron-burr-web/musiclab/blob/main/js/pitch-learning.js"
click node_melody_learning "https://github.com/aaron-burr-web/musiclab/blob/main/js/pitch-melodies.js"
click node_notation_learning "https://github.com/aaron-burr-web/musiclab/blob/main/js/pitch-notation.js"
click node_ear_training "https://github.com/aaron-burr-web/musiclab/blob/main/js/ear-training.js"
click node_lesson_quiz "https://github.com/aaron-burr-web/musiclab/blob/main/js/lesson-quiz.js"
click node_playground "https://github.com/aaron-burr-web/musiclab/blob/main/js/playground-sequencer.js"
click node_track_demo "https://github.com/aaron-burr-web/musiclab/blob/main/js/track-demo.js"
click node_audio_engine "https://github.com/aaron-burr-web/musiclab/blob/main/js/audio-engine.js"
click node_audio_samples "https://github.com/aaron-burr-web/musiclab/tree/main/audio"
click node_practice_keyboard "https://github.com/aaron-burr-web/musiclab/blob/main/js/practice-keyboard.js"
click node_shared_ui "https://github.com/aaron-burr-web/musiclab/blob/main/js/musiclab-ui.js"
click node_profile_storage "https://github.com/aaron-burr-web/musiclab/blob/main/js/musiclab-ui.js"
click node_qa "https://github.com/aaron-burr-web/musiclab/blob/main/js/QA.js"
click node_account_pages "https://github.com/aaron-burr-web/musiclab/tree/main/login"
click node_login_logic "https://github.com/aaron-burr-web/musiclab/blob/main/js/login.js"
click node_terms "https://github.com/aaron-burr-web/musiclab/blob/main/js/terms.js"
click node_contact_page "https://github.com/aaron-burr-web/musiclab/blob/main/contact/contact.html"
click node_settings_page "https://github.com/aaron-burr-web/musiclab/blob/main/settings/settings.html"

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_lesson_pages,node_beat_demo,node_chord_learning,node_pitch_learning,node_melody_learning,node_notation_learning,node_ear_training,node_lesson_quiz,node_practice_keyboard toneBlue
class node_playground,node_track_demo,node_audio_engine,node_audio_samples toneAmber
class node_shared_ui,node_profile_storage,node_qa toneMint
class node_account_pages,node_login_logic,node_terms,node_contact_page,node_settings_page toneRose
class node_learner toneIndigo
```

## Components

### Lessons and practice

- [Lesson pages](https://github.com/aaron-burr-web/musiclab/tree/main/Start%20Learning): `Start Learning`
- [Beat demonstrations](https://github.com/aaron-burr-web/musiclab/blob/main/js/beat-demo.js): `js/beat-demo.js`
- [Chord exercises](https://github.com/aaron-burr-web/musiclab/blob/main/js/chords-learning.js): `js/chords-learning.js`
- [Pitch lessons](https://github.com/aaron-burr-web/musiclab/blob/main/js/pitch-learning.js): `js/pitch-learning.js`
- [Melody lessons](https://github.com/aaron-burr-web/musiclab/blob/main/js/pitch-melodies.js): `js/pitch-melodies.js`
- [Notation lessons](https://github.com/aaron-burr-web/musiclab/blob/main/js/pitch-notation.js): `js/pitch-notation.js`
- [Ear training](https://github.com/aaron-burr-web/musiclab/blob/main/js/ear-training.js): `js/ear-training.js`
- [Lesson quizzes](https://github.com/aaron-burr-web/musiclab/blob/main/js/lesson-quiz.js): `js/lesson-quiz.js`
- [Practice keyboard](https://github.com/aaron-burr-web/musiclab/blob/main/js/practice-keyboard.js): `js/practice-keyboard.js`

### Music creation and audio

- [Playground sequencer](https://github.com/aaron-burr-web/musiclab/blob/main/js/playground-sequencer.js): `js/playground-sequencer.js`
- [Four-track demo](https://github.com/aaron-burr-web/musiclab/blob/main/js/track-demo.js): `js/track-demo.js`
- [Audio engine](https://github.com/aaron-burr-web/musiclab/blob/main/js/audio-engine.js): `js/audio-engine.js`
- [Audio samples](https://github.com/aaron-burr-web/musiclab/tree/main/audio): `audio`

### Shared platform

- [Shared UI and state](https://github.com/aaron-burr-web/musiclab/blob/main/js/musiclab-ui.js): `js/musiclab-ui.js`
- [Browser-local records](https://github.com/aaron-burr-web/musiclab/blob/main/js/musiclab-ui.js): `js/musiclab-ui.js`
- [Learner questionnaire](https://github.com/aaron-burr-web/musiclab/blob/main/js/QA.js): `js/QA.js`

### Accounts and support

- [Login and registration](https://github.com/aaron-burr-web/musiclab/tree/main/login): `login`
- [Account handling](https://github.com/aaron-burr-web/musiclab/blob/main/js/login.js): `js/login.js`
- [Service terms](https://github.com/aaron-burr-web/musiclab/blob/main/js/terms.js): `js/terms.js`
- [Contact and feedback](https://github.com/aaron-burr-web/musiclab/blob/main/contact/contact.html): `contact/contact.html`
- [Settings](https://github.com/aaron-burr-web/musiclab/blob/main/settings/settings.html): `settings/settings.html`

### Other components

- **Learner**

## Connections

- Learner → Lesson pages: opens lessons (evidence: `README.md`)
- Lesson pages → Beat demonstrations: offers demonstrations (evidence: `README.md`)
- Lesson pages → Chord exercises: offers exercises (evidence: `README.md`)
- Lesson pages → Pitch lessons: teaches pitch (evidence: `README.md`)
- Lesson pages → Melody lessons: teaches melodies (evidence: `README.md`)
- Lesson pages → Notation lessons: teaches notation (evidence: `README.md`)
- Lesson pages → Ear training: offers listening practice (evidence: `README.md`)
- Lesson pages → Lesson quizzes: hosts chapter quizzes (evidence: `js/lesson-quiz.js`)
- Lesson quizzes → Shared UI and state: uses progress API (evidence: `js/lesson-quiz.js`)
- Shared UI and state → Browser-local records: stores local progress (evidence: `README.md`)
- Learner → Playground sequencer: creates music (evidence: `README.md`)
- Learner → Practice keyboard: practices notes (evidence: `README.md`)
- Learner → Four-track demo: tries track combinations (evidence: `README.md`)
- Playground sequencer → Audio engine: uses shared audio (evidence: `js/audio-engine.js`)
- Beat demonstrations → Audio samples: plays samples (evidence: `README.md`)
- Ear training → Audio engine: plays notes (evidence: `js/ear-training.js`)
- Chord exercises → Audio engine: plays chords (evidence: `js/chords-learning.js`)
- Learner → Learner questionnaire: answers questionnaire (evidence: `README.md`)
- Learner → Login and registration: registers or logs in (evidence: `README.md`)
- Login and registration → Account handling: submits account forms (evidence: `README.md`)
- Account handling → Browser-local records: stores account locally (evidence: `README.md`)
- Learner → Settings: manages preferences (evidence: `README.md`)
- Learner → Contact and feedback: sends feedback (evidence: `README.md`)
- Login and registration → Service terms: opens terms (evidence: `js/terms.js`)
