# georgiebognalbal/jctgbtg-music-library architecture

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

- Interactive diagram: https://gitdiagram.com/georgiebognalbal/jctgbtg-music-library
- Repository: https://github.com/georgiebognalbal/jctgbtg-music-library

## Overview

Church Lyrics is a browser-based song and lyrics library. Users load and search the catalog, open a song, and can add, edit, or delete entries; the frontend calls a FastAPI service that reads and writes Supabase. The browser also keeps favorites and display preferences locally, and supports copying or sharing lyrics. The excerpts establish the main frontend actions and backend routes, but do not show the SQL schema or HTML/CSS behavior in detail.

Main entry points: [`frontend/script.js`](https://github.com/georgiebognalbal/jctgbtg-music-library/blob/main/frontend/script.js) (API client), [`frontend/index.html`](https://github.com/georgiebognalbal/jctgbtg-music-library/blob/main/frontend/index.html) (Library page), [`backend/main.py`](https://github.com/georgiebognalbal/jctgbtg-music-library/blob/main/backend/main.py) (Song catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Browser application"]
  node_page["Library page<br/>[index.html]"]
  node_ui["Library interactions<br/>[script.js]"]
  node_api_client["API client<br/>[script.js]"]
end

subgraph group_service["Song service"]
  node_catalog["Song catalog<br/>[main.py]"]
  node_song_detail["Song detail<br/>[main.py]"]
  node_create_song["Create song<br/>[main.py]"]
  node_edit_song["Edit song<br/>[main.py]"]
  node_remove_song["Delete song<br/>[main.py]"]
end

subgraph group_persistence["Persistence and sharing"]
  node_supabase[("Supabase songs")]
  node_local_storage[("Browser preferences<br/>[script.js]")]
  node_clipboard["Clipboard and share<br/>[script.js]"]
end

node_user(("Library user"))

node_user -->|"uses"| node_page
node_page -.->|"hosts"| node_ui
node_ui -->|"requests"| node_api_client
node_api_client -->|"fetches catalog"| node_catalog
node_api_client -->|"fetches song"| node_song_detail
node_api_client -->|"creates song"| node_create_song
node_api_client -->|"updates song"| node_edit_song
node_api_client -->|"deletes song"| node_remove_song
node_catalog -->|"reads songs"| node_supabase
node_song_detail -->|"reads song"| node_supabase
node_create_song -->|"inserts song"| node_supabase
node_edit_song -->|"updates song"| node_supabase
node_remove_song -->|"deletes song"| node_supabase
node_ui -->|"stores preferences"| node_local_storage
node_ui -->|"copies or shares"| node_clipboard

click node_page "https://github.com/georgiebognalbal/jctgbtg-music-library/blob/main/frontend/index.html"
click node_ui "https://github.com/georgiebognalbal/jctgbtg-music-library/blob/main/frontend/script.js"
click node_api_client "https://github.com/georgiebognalbal/jctgbtg-music-library/blob/main/frontend/script.js"
click node_catalog "https://github.com/georgiebognalbal/jctgbtg-music-library/blob/main/backend/main.py"
click node_song_detail "https://github.com/georgiebognalbal/jctgbtg-music-library/blob/main/backend/main.py"
click node_create_song "https://github.com/georgiebognalbal/jctgbtg-music-library/blob/main/backend/main.py"
click node_edit_song "https://github.com/georgiebognalbal/jctgbtg-music-library/blob/main/backend/main.py"
click node_remove_song "https://github.com/georgiebognalbal/jctgbtg-music-library/blob/main/backend/main.py"
click node_local_storage "https://github.com/georgiebognalbal/jctgbtg-music-library/blob/main/frontend/script.js"
click node_clipboard "https://github.com/georgiebognalbal/jctgbtg-music-library/blob/main/frontend/script.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_page,node_ui,node_api_client,node_user toneBlue
class node_catalog,node_song_detail,node_create_song,node_edit_song,node_remove_song toneAmber
class node_supabase,node_local_storage,node_clipboard toneMint
```

## Components

### Browser application

- [Library page](https://github.com/georgiebognalbal/jctgbtg-music-library/blob/main/frontend/index.html): `frontend/index.html`
- [Library interactions](https://github.com/georgiebognalbal/jctgbtg-music-library/blob/main/frontend/script.js): `frontend/script.js`
- [API client](https://github.com/georgiebognalbal/jctgbtg-music-library/blob/main/frontend/script.js): `frontend/script.js`

### Song service

- [Song catalog](https://github.com/georgiebognalbal/jctgbtg-music-library/blob/main/backend/main.py): `backend/main.py`
- [Song detail](https://github.com/georgiebognalbal/jctgbtg-music-library/blob/main/backend/main.py): `backend/main.py`
- [Create song](https://github.com/georgiebognalbal/jctgbtg-music-library/blob/main/backend/main.py): `backend/main.py`
- [Edit song](https://github.com/georgiebognalbal/jctgbtg-music-library/blob/main/backend/main.py): `backend/main.py`
- [Delete song](https://github.com/georgiebognalbal/jctgbtg-music-library/blob/main/backend/main.py): `backend/main.py`

### Persistence and sharing

- **Supabase songs**
- [Browser preferences](https://github.com/georgiebognalbal/jctgbtg-music-library/blob/main/frontend/script.js): `frontend/script.js`
- [Clipboard and share](https://github.com/georgiebognalbal/jctgbtg-music-library/blob/main/frontend/script.js): `frontend/script.js`

### Other components

- **Library user**

## Connections

- Library user → Library page: uses
- Library page → Library interactions: hosts
- Library interactions → API client: requests (evidence: `frontend/script.js`)
- API client → Song catalog: fetches catalog (evidence: `frontend/script.js`)
- API client → Song detail: fetches song (evidence: `frontend/script.js`)
- API client → Create song: creates song (evidence: `frontend/script.js`)
- API client → Edit song: updates song (evidence: `frontend/script.js`)
- API client → Delete song: deletes song (evidence: `frontend/script.js`)
- Song catalog → Supabase songs: reads songs (evidence: `backend/main.py`)
- Song detail → Supabase songs: reads song (evidence: `backend/main.py`)
- Create song → Supabase songs: inserts song (evidence: `backend/main.py`)
- Edit song → Supabase songs: updates song (evidence: `backend/main.py`)
- Delete song → Supabase songs: deletes song (evidence: `backend/main.py`)
- Library interactions → Browser preferences: stores preferences (evidence: `frontend/script.js`)
- Library interactions → Clipboard and share: copies or shares (evidence: `frontend/script.js`)
