Guitar Lab ♭⟩

\n Your personal music-theory workbench. Visualize any scale on the fretboard, work\n through the curriculum, and drill your ear.\n

\n );\n}\n\nexport function App() {\n const [tab, setTab] = useState(\"lessons\");\n\n return (\n

\n \n\n \n\n

\n {tab === \"lessons\" && }\n {tab === \"lab\" && }\n {tab === \"metronome\" && }\n {tab === \"trainer\" && }\n

\n\n \n

\n );\n}\n","label",[167,168,68],"frontend","components","pulls","branches","forks","envVars",{"_176":26,"_178":26},"connections",{"_176":26,"_177":26},"count","unfilledCount","emptyCount",{"_33":297,"_13":167,"_66":219,"_43":-5,"_35":36,"_160":40,"_161":97,"_37":298,"_39":26,"_69":294,"_163":-5,"_71":24,"_165":-5,"_199":299,"_17":300},{"_33":292,"_13":168,"_66":159,"_43":219,"_35":36,"_160":40,"_161":97,"_37":293,"_39":26,"_69":294,"_163":-5,"_71":24,"_165":-5,"_199":295,"_17":296},{"_33":158,"_13":68,"_66":67,"_43":159,"_35":36,"_160":77,"_161":97,"_37":289,"_39":40,"_69":70,"_163":164,"_71":24,"_165":-5,"_199":290,"_17":291},{"_33":280,"_13":281,"_66":282,"_43":159,"_35":36,"_160":283,"_161":97,"_37":284,"_39":285,"_69":70,"_163":286,"_71":24,"_165":-5,"_199":287,"_17":288},{"_33":272,"_13":273,"_66":274,"_43":159,"_35":36,"_160":275,"_161":97,"_37":276,"_39":252,"_69":70,"_163":277,"_71":24,"_165":-5,"_199":278,"_17":279},{"_33":264,"_13":265,"_66":266,"_43":159,"_35":36,"_160":267,"_161":97,"_37":268,"_39":26,"_69":70,"_163":269,"_71":24,"_165":-5,"_199":270,"_17":271},{"_33":256,"_13":257,"_66":258,"_43":159,"_35":36,"_160":259,"_161":97,"_37":260,"_39":26,"_69":70,"_163":261,"_71":24,"_165":-5,"_199":262,"_17":263},{"_33":247,"_13":248,"_66":249,"_43":159,"_35":36,"_160":250,"_161":97,"_37":251,"_39":252,"_69":70,"_163":253,"_71":24,"_165":-5,"_199":254,"_17":255},{"_33":240,"_13":241,"_66":242,"_43":219,"_35":36,"_160":40,"_161":97,"_37":243,"_39":26,"_69":21,"_163":244,"_71":24,"_165":-5,"_199":245,"_17":246},{"_33":233,"_13":234,"_66":235,"_43":219,"_35":36,"_160":40,"_161":97,"_37":236,"_39":26,"_69":70,"_163":237,"_71":24,"_165":-5,"_199":238,"_17":239},{"_33":225,"_13":226,"_66":227,"_43":219,"_35":36,"_160":228,"_161":97,"_37":229,"_39":40,"_69":70,"_163":230,"_71":24,"_165":-5,"_199":231,"_17":232},{"_33":216,"_13":217,"_66":218,"_43":219,"_35":36,"_160":220,"_161":97,"_37":221,"_39":26,"_69":70,"_163":222,"_71":24,"_165":-5,"_199":223,"_17":224},{"_33":209,"_13":210,"_66":211,"_43":-5,"_35":36,"_160":40,"_161":97,"_37":212,"_39":26,"_69":21,"_163":213,"_71":24,"_165":-5,"_199":214,"_17":215},{"_33":202,"_13":203,"_66":204,"_43":-5,"_35":36,"_160":123,"_161":97,"_37":205,"_39":40,"_69":21,"_163":206,"_71":24,"_165":-5,"_199":207,"_17":208},{"_33":194,"_13":195,"_66":95,"_43":-5,"_35":36,"_160":40,"_161":97,"_37":196,"_39":26,"_69":197,"_163":198,"_71":24,"_165":14,"_199":200,"_17":201},"880e574a-09c0-49a4-a75e-cac9fd705d83","index.ts",["D",1787421842194],"http","import { parseVal, serveImmutableFile } from \"https://esm.town/v/std/utils/index.ts\";\nimport { Hono } from \"npm:hono\";\nimport { Root } from \"./frontend/root.tsx\";\n\nconst app = new Hono();\n\n// Serve the (never-cached) HTML shell at the root /\napp.get(\"/\", (c) => c.html(Root()));\n\n// Serve frontend files at the version-addressed URLs Root() stamps, cached immutably\napp.get(\"/__immutable/*\", (c) => serveImmutableFile(c.req.path));\n\n// View source redirect\napp.get(\"/source\", (c) => c.redirect(parseVal().links.self.val));\n\n// Add your API routes here\n// app.get(\"/api/data\", c => c.json({ hello: \"world\" }));\n\n// Unwrap and rethrow Hono errors as the original error\n// If you delete this, all errors will be \"Internal Server Error\"\napp.onError((err) => Promise.reject(err));\n\n// HTTP vals expect an exported \"fetch handler\"\n// This is how you \"run the server\" in Val Town with Hono\nexport default app.fetch;\n","children",[],[195],"25b11362-17a0-4df7-b216-341ce700c92f","README.md","01a02aa4-dbb8-719f-bc43-17d83a46fa8b",["D",1787422030009],"# Guitar Lab 🎸\n\nA personal music theory & scales workbench — visualize any scale on the fretboard,\nwork through a structured curriculum, and drill your ear. Built for an intermediate\nguitarist whose main goal is scales and music theory.\n\n**Live:** https://guitar-lab.val.run\n\n## What's inside\n\n| Tab | What it does |\n| --- | --- |\n| **Lessons** | A 6-part curriculum (fretboard logic → intervals → major scale construction → pentatonics → modes → diatonic harmony), each with embedded live fretboard examples |\n| **Scale Lab** | Pick any root + one of 13 scales, see it color-coded across the whole neck. Toggle note names vs interval degrees (1, ♭3, 5…), and *hear* the scale ascend |\n| **Metronome** | Web-audio clicker, BPM 40–240, 3/4 · 4/4 · 6/4 time with accented beat one |\n| **Interval Trainer** | Ear-training game: hear two notes, name the interval, get instant feedback and a score |\n\n## Architecture\n\n```mermaid\ngraph LR\n Browser -->|\"GET /\"| Hono[\"index.ts (Hono server)\"]\n Hono -->|serves| Root[\"frontend/root.tsx (HTML shell)\"]\n Root -->|loads| Entry[\"frontend/index.tsx\"]\n Entry -->|renders| App[\"App.tsx (nav + layout)\"]\n App --> Lessons[\"Lessons.tsx\"]\n App --> Explorer[\"ScaleExplorer.tsx\"]\n App --> Metronome[\"Metronome.tsx\"]\n App --> Trainer[\"IntervalTrainer.tsx\"]\n Explorer --> Fretboard[\"Fretboard.tsx\"]\n Fretboard --> Theory[\"theory.ts (notes, scales, intervals, neck)\"]\n```\n\n## How it works\n\n- **`theory.ts`** is the engine — note names, interval labels, 13 scale formulas, and a\n fretboard grid builder. `mapScale()` colors every note on the neck by its scale degree.\n- **Client-side React** (no build step). Twind/Tailwind utilities for styling.\n- All audio is generated with the **Web Audio API** (oscillators) — no audio files.\n- Every frontend module is served at versioned URLs via `serveImmutableFile` and cached immutably.\n\n## Ideas for next iteration\n\n- A **chord explorer** (stack thirds off any scale degree to derive chords)\n- **Practice tracker** (habit streaks, saved to the val's SQLite + cron daily reminder)\n- **Note-to-fret finder** tool\n- Microphone pitch detection for real guitar input\n\n## File structure\n\n```\nfrontend/\n theory.ts Music theory + fretboard engine\n root.tsx HTML shell (stamps immutable asset URLs)\n index.tsx React entrypoint\n components/\n App.tsx Nav + layout\n Lessons.tsx 6-lesson curriculum\n ScaleExplorer.tsx Interactive root/scale explorer + audio\n Fretboard.tsx Neck renderer\n Metronome.tsx Web-audio clicker\n IntervalTrainer.tsx Ear-training quiz\n```\n",[],[203],"dbc48714-2533-466b-bc51-6d25e955f35e","CHANGELOG.md","01a02aa4-dbb8-719f-bc43-13e217c72655",["D",1787421842194],"# Changelog\n\n## 2026-07-30 — Immutable asset caching\n\nFrontend files are now served at version-addressed URLs\n(`/__immutable/45/frontend/index.tsx`) with\n`Cache-Control: public, max-age=31536000, immutable`, so repeat visits load the\nwhole client graph from the browser cache — roughly 3× faster (~665ms → ~157ms\nmeasured). Publishing your val bumps its version, which changes every URL, so\ncaches invalidate automatically. Old-version URLs return 404 after a publish\n(like Next.js build assets); a reload picks up the new version.\n\nWhat changed in the template:\n\n- `frontend/index.html` → [`frontend/root.tsx`](/frontend/root.tsx): the HTML\n shell is now JSX and stamps asset URLs with `immutableFileUrl()`\n- [`index.ts`](/index.ts): serves `Root()` at `/`, and one\n `app.get(\"/__immutable/*\", (c) => serveImmutableFile(c.req.path))` route\n serves all frontend files\n\n### Upgrading an existing remix\n\nYour copy of this template doesn't update automatically. Two options:\n\n**Minimal (most of the benefit):** point both routes at `serveImmutableFile` —\nyour existing bare URLs redirect into versioned space, the new route serves\nthem, and the whole module graph gets cached (costs one redirect per page view):\n\n```ts\nimport { serveImmutableFile } from \"https://esm.town/v/std/utils/index.ts\";\n\napp.get(\"/__immutable/*\", (c) => serveImmutableFile(c.req.path));\napp.get(\"/frontend/**/*\", (c) => serveImmutableFile(c.req.path)); // was serveFile\n```\n\n**Full upgrade (also removes the redirect):** three self-contained steps —\nno other files needed. Adjust the ``, favicon, and body of `Root()` to\nmatch your app's existing `index.html`, and stamp anything else your shell\nreferences directly (images, css) with `immutableFileUrl()`.\n\n1. Create `frontend/root.tsx`:\n\n```tsx\n/** @jsxImportSource npm:hono@4/jsx */\nimport { raw } from \"npm:hono@4/html\";\nimport { immutableFileUrl } from \"https://esm.town/v/std/utils/index.ts\";\n\n// The HTML shell for the app. It is never cached, so immutableFileUrl can stamp\n// the current val version into each asset URL — the browser caches those\n// immutably, and publishing the val changes the URLs, refetching exactly once.\nexport function Root() {\n return (\n <>\n {raw(\"<!DOCTYPE html>\")}\n <html lang=\"en\">\n <head>\n <meta charSet=\"UTF-8\" />\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n <title>React Hono Val Town Starter\n

History · App.tsx