# mandobala/mandolinbalajipwa architecture

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

- Interactive diagram: https://gitdiagram.com/mandobala/mandolinbalajipwa
- Repository: https://github.com/mandobala/mandolinbalajipwa

## Overview

Mandolin Balaji is an Astro portfolio and music-learning site. Visitors browse the site’s song notation, open individual song pages, or use the Swara Player; other documented site areas include video lessons, testimonials, and practice tools. The notation library is a distinct content stage, and its shared song model also supplies sitemap data. The tree and excerpts support the player’s use of the notation engine and the song model’s sitemap use. Several listed public ID3 modules are included as a separate media-metadata capability; their connection to site pages is not established by the available evidence.

Main entry points: [`src/pages`](https://github.com/mandobala/mandolinbalajipwa/tree/main/src/pages) (Site Pages), [`public/js/id3.js`](https://github.com/mandobala/mandolinbalajipwa/blob/main/public/js/id3.js) (ID3 Parsing), [`src/lib/songs.ts`](https://github.com/mandobala/mandolinbalajipwa/blob/main/src/lib/songs.ts) (Song Library), [`public/js/id3Tag.js`](https://github.com/mandobala/mandolinbalajipwa/blob/main/public/js/id3Tag.js) (Tag Parser)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Site Experience"]
  node_site_pages["Site Pages"]
  node_sitemap["Sitemap<br/>[sitemap.xml.ts]"]
  node_video_lessons["Video Lessons"]
  node_testimonials["Testimonials<br/>[testimonials.astro]"]
end

subgraph group_songs["Notation and Playback"]
  node_song_content["Song Notation"]
  node_song_model["Song Library<br/>[songs.ts]"]
  node_song_pages["Song Pages<br/>[&#91;slug&#93;.astro]"]
  node_player_page["Swara Player Page<br/>[swara-player.astro]"]
  node_notation_engine["Notation Engine<br/>[engine.js]"]
  node_player_client["Player Client<br/>[player.js]"]
end

subgraph group_practice["Practice Tools"]
  node_practice_studio["Practice Studio"]
  node_practice_club["Practice Club"]
  node_tuner["Tuner<br/>[tuner.astro]"]
end

subgraph group_media["Media Metadata"]
  node_id3_api["ID3 Parsing<br/>[id3.js]"]
  node_id3_tags["Tag Parser<br/>[id3Tag.js]"]
  node_id3_frames["Frame Parser<br/>[id3Frame.js]"]
  node_reader_base["Reader Interface<br/>[reader.js]"]
  node_browser_reader["Browser Reader"]
  node_local_reader["Local Reader<br/>[localReader.js]"]
  node_remote_reader["Remote Reader<br/>[remoteReader.js]"]
  node_genres["Genre Table<br/>[genres.js]"]
  node_id3_util["Binary Utilities<br/>[util.js]"]
end

node_visitor(("Site Visitor"))

node_visitor -->|"browses"| node_site_pages
node_site_pages -.->|"includes"| node_song_pages
node_song_content -->|"parsed by"| node_song_model
node_song_model -->|"supplies songs"| node_sitemap
node_song_model -.->|"builds pages"| node_song_pages
node_song_model -.->|"provides song data"| node_player_page
node_player_page -.->|"hosts playback"| node_player_client
node_player_client -->|"parses notation"| node_notation_engine
node_site_pages -.->|"includes"| node_video_lessons
node_site_pages -.->|"includes"| node_testimonials
node_site_pages -.->|"includes"| node_practice_studio
node_site_pages -.->|"includes"| node_practice_club
node_site_pages -.->|"includes"| node_tuner
node_id3_api -->|"parses tags"| node_id3_tags
node_id3_api -->|"uses reader"| node_browser_reader
node_id3_api -->|"uses reader"| node_local_reader
node_id3_api -->|"uses reader"| node_remote_reader
node_local_reader -->|"extends"| node_reader_base
node_browser_reader -->|"uses interface"| node_reader_base
node_remote_reader -->|"uses interface"| node_reader_base
node_id3_tags -->|"parses frames"| node_id3_frames
node_id3_tags -->|"looks up genres"| node_genres
node_id3_tags -->|"decodes bytes"| node_id3_util
node_id3_frames -->|"looks up genres"| node_genres
node_id3_frames -->|"decodes bytes"| node_id3_util

click node_site_pages "https://github.com/mandobala/mandolinbalajipwa/tree/main/src/pages"
click node_song_content "https://github.com/mandobala/mandolinbalajipwa/tree/main/src/content/songs"
click node_song_model "https://github.com/mandobala/mandolinbalajipwa/blob/main/src/lib/songs.ts"
click node_song_pages "https://github.com/mandobala/mandolinbalajipwa/blob/main/src/pages/notes/%5Bslug%5D.astro"
click node_player_page "https://github.com/mandobala/mandolinbalajipwa/blob/main/src/pages/swara-player.astro"
click node_notation_engine "https://github.com/mandobala/mandolinbalajipwa/blob/main/src/lib/swara/engine.js"
click node_player_client "https://github.com/mandobala/mandolinbalajipwa/blob/main/src/components/swara/player.js"
click node_sitemap "https://github.com/mandobala/mandolinbalajipwa/blob/main/src/pages/sitemap.xml.ts"
click node_video_lessons "https://github.com/mandobala/mandolinbalajipwa/blob/main/src/pages/video-lessons.astro"
click node_testimonials "https://github.com/mandobala/mandolinbalajipwa/blob/main/src/pages/testimonials.astro"
click node_practice_studio "https://github.com/mandobala/mandolinbalajipwa/blob/main/src/pages/practice-studio.astro"
click node_practice_club "https://github.com/mandobala/mandolinbalajipwa/blob/main/src/pages/practice-club.astro"
click node_tuner "https://github.com/mandobala/mandolinbalajipwa/blob/main/src/pages/tuner.astro"
click node_id3_api "https://github.com/mandobala/mandolinbalajipwa/blob/main/public/js/id3.js"
click node_id3_tags "https://github.com/mandobala/mandolinbalajipwa/blob/main/public/js/id3Tag.js"
click node_id3_frames "https://github.com/mandobala/mandolinbalajipwa/blob/main/public/js/id3Frame.js"
click node_reader_base "https://github.com/mandobala/mandolinbalajipwa/blob/main/public/js/reader.js"
click node_browser_reader "https://github.com/mandobala/mandolinbalajipwa/blob/main/public/js/browserFileReader.js"
click node_local_reader "https://github.com/mandobala/mandolinbalajipwa/blob/main/public/js/localReader.js"
click node_remote_reader "https://github.com/mandobala/mandolinbalajipwa/blob/main/public/js/remoteReader.js"
click node_genres "https://github.com/mandobala/mandolinbalajipwa/blob/main/public/js/genres.js"
click node_id3_util "https://github.com/mandobala/mandolinbalajipwa/blob/main/public/js/util.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_site_pages,node_sitemap,node_video_lessons,node_testimonials toneBlue
class node_song_content,node_song_model,node_song_pages,node_player_page,node_notation_engine,node_player_client toneAmber
class node_practice_studio,node_practice_club,node_tuner toneMint
class node_id3_api,node_id3_tags,node_id3_frames,node_reader_base,node_browser_reader,node_local_reader,node_remote_reader,node_genres,node_id3_util toneRose
class node_visitor toneIndigo
```

## Components

### Site Experience

- [Site Pages](https://github.com/mandobala/mandolinbalajipwa/tree/main/src/pages): `src/pages`
- [Sitemap](https://github.com/mandobala/mandolinbalajipwa/blob/main/src/pages/sitemap.xml.ts): `src/pages/sitemap.xml.ts`
- [Video Lessons](https://github.com/mandobala/mandolinbalajipwa/blob/main/src/pages/video-lessons.astro): `src/pages/video-lessons.astro`
- [Testimonials](https://github.com/mandobala/mandolinbalajipwa/blob/main/src/pages/testimonials.astro): `src/pages/testimonials.astro`

### Notation and Playback

- [Song Notation](https://github.com/mandobala/mandolinbalajipwa/tree/main/src/content/songs): `src/content/songs`
- [Song Library](https://github.com/mandobala/mandolinbalajipwa/blob/main/src/lib/songs.ts): `src/lib/songs.ts`
- [Song Pages](https://github.com/mandobala/mandolinbalajipwa/blob/main/src/pages/notes/%5Bslug%5D.astro): `src/pages/notes/[slug].astro`
- [Swara Player Page](https://github.com/mandobala/mandolinbalajipwa/blob/main/src/pages/swara-player.astro): `src/pages/swara-player.astro`
- [Notation Engine](https://github.com/mandobala/mandolinbalajipwa/blob/main/src/lib/swara/engine.js): `src/lib/swara/engine.js`
- [Player Client](https://github.com/mandobala/mandolinbalajipwa/blob/main/src/components/swara/player.js): `src/components/swara/player.js`

### Practice Tools

- [Practice Studio](https://github.com/mandobala/mandolinbalajipwa/blob/main/src/pages/practice-studio.astro): `src/pages/practice-studio.astro`
- [Practice Club](https://github.com/mandobala/mandolinbalajipwa/blob/main/src/pages/practice-club.astro): `src/pages/practice-club.astro`
- [Tuner](https://github.com/mandobala/mandolinbalajipwa/blob/main/src/pages/tuner.astro): `src/pages/tuner.astro`

### Media Metadata

- [ID3 Parsing](https://github.com/mandobala/mandolinbalajipwa/blob/main/public/js/id3.js): `public/js/id3.js`
- [Tag Parser](https://github.com/mandobala/mandolinbalajipwa/blob/main/public/js/id3Tag.js): `public/js/id3Tag.js`
- [Frame Parser](https://github.com/mandobala/mandolinbalajipwa/blob/main/public/js/id3Frame.js): `public/js/id3Frame.js`
- [Reader Interface](https://github.com/mandobala/mandolinbalajipwa/blob/main/public/js/reader.js): `public/js/reader.js`
- [Browser Reader](https://github.com/mandobala/mandolinbalajipwa/blob/main/public/js/browserFileReader.js): `public/js/browserFileReader.js`
- [Local Reader](https://github.com/mandobala/mandolinbalajipwa/blob/main/public/js/localReader.js): `public/js/localReader.js`
- [Remote Reader](https://github.com/mandobala/mandolinbalajipwa/blob/main/public/js/remoteReader.js): `public/js/remoteReader.js`
- [Genre Table](https://github.com/mandobala/mandolinbalajipwa/blob/main/public/js/genres.js): `public/js/genres.js`
- [Binary Utilities](https://github.com/mandobala/mandolinbalajipwa/blob/main/public/js/util.js): `public/js/util.js`

### Other components

- **Site Visitor**

## Connections

- Site Visitor → Site Pages: browses (evidence: `README.md`)
- Site Pages → Song Pages: includes
- Song Notation → Song Library: parsed by (evidence: `src/lib/songs.ts`)
- Song Library → Sitemap: supplies songs (evidence: `src/pages/sitemap.xml.ts`)
- Song Library → Song Pages: builds pages
- Song Library → Swara Player Page: provides song data
- Swara Player Page → Player Client: hosts playback
- Player Client → Notation Engine: parses notation (evidence: `src/components/swara/player.js`)
- Site Pages → Video Lessons: includes
- Site Pages → Testimonials: includes
- Site Pages → Practice Studio: includes
- Site Pages → Practice Club: includes
- Site Pages → Tuner: includes
- ID3 Parsing → Tag Parser: parses tags (evidence: `public/js/id3.js`)
- ID3 Parsing → Browser Reader: uses reader (evidence: `public/js/id3.js`)
- ID3 Parsing → Local Reader: uses reader (evidence: `public/js/id3.js`)
- ID3 Parsing → Remote Reader: uses reader (evidence: `public/js/id3.js`)
- Local Reader → Reader Interface: extends (evidence: `public/js/localReader.js`)
- Browser Reader → Reader Interface: uses interface (evidence: `public/js/browserFileReader.js`)
- Remote Reader → Reader Interface: uses interface (evidence: `public/js/remoteReader.js`)
- Tag Parser → Frame Parser: parses frames (evidence: `public/js/id3Tag.js`)
- Tag Parser → Genre Table: looks up genres (evidence: `public/js/id3Tag.js`)
- Tag Parser → Binary Utilities: decodes bytes (evidence: `public/js/id3Tag.js`)
- Frame Parser → Genre Table: looks up genres (evidence: `public/js/id3Frame.js`)
- Frame Parser → Binary Utilities: decodes bytes (evidence: `public/js/id3Frame.js`)
