`, 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

{bpm}

BPM — beat {formatBpm(bpm)}

\n changeBpm(Number(e.target.value))}\n className=\"w-full accent-emerald-600 mt-3\"\n />\n

\n\n

\n {[3, 4, 6].map((ts) => (\n \n ))}\n

\n\n \n {running ? \"■ Stop\" : \"▶ Start\"}\n \n

Accented click = beat one. First click happens on press.

\n );\n}\n","label",[155,156,64],"frontend","components","pulls","branches",1,"forks","envVars",{"_165":26,"_167":26},"connections",{"_165":26,"_166":26},"count","unfilledCount","emptyCount",{"_32":286,"_13":155,"_62":208,"_42":-5,"_34":35,"_148":159,"_149":85,"_36":287,"_38":26,"_65":283,"_151":-5,"_67":24,"_153":-5,"_188":288,"_17":289},{"_32":281,"_13":156,"_62":147,"_42":208,"_34":35,"_148":159,"_149":85,"_36":282,"_38":26,"_65":283,"_151":-5,"_67":24,"_153":-5,"_188":284,"_17":285},{"_32":273,"_13":274,"_62":275,"_42":147,"_34":35,"_148":276,"_149":85,"_36":277,"_38":159,"_65":66,"_151":278,"_67":24,"_153":-5,"_188":279,"_17":280},{"_32":264,"_13":265,"_62":266,"_42":147,"_34":35,"_148":267,"_149":85,"_36":268,"_38":269,"_65":66,"_151":270,"_67":24,"_153":-5,"_188":271,"_17":272},{"_32":256,"_13":257,"_62":258,"_42":147,"_34":35,"_148":259,"_149":85,"_36":260,"_38":241,"_65":66,"_151":261,"_67":24,"_153":-5,"_188":262,"_17":263},{"_32":248,"_13":249,"_62":250,"_42":147,"_34":35,"_148":251,"_149":85,"_36":252,"_38":26,"_65":66,"_151":253,"_67":24,"_153":-5,"_188":254,"_17":255},{"_32":146,"_13":64,"_62":63,"_42":147,"_34":35,"_148":39,"_149":85,"_36":245,"_38":26,"_65":66,"_151":152,"_67":24,"_153":-5,"_188":246,"_17":247},{"_32":236,"_13":237,"_62":238,"_42":147,"_34":35,"_148":239,"_149":85,"_36":240,"_38":241,"_65":66,"_151":242,"_67":24,"_153":-5,"_188":243,"_17":244},{"_32":229,"_13":230,"_62":231,"_42":208,"_34":35,"_148":159,"_149":85,"_36":232,"_38":26,"_65":21,"_151":233,"_67":24,"_153":-5,"_188":234,"_17":235},{"_32":222,"_13":223,"_62":224,"_42":208,"_34":35,"_148":159,"_149":85,"_36":225,"_38":26,"_65":66,"_151":226,"_67":24,"_153":-5,"_188":227,"_17":228},{"_32":214,"_13":215,"_62":216,"_42":208,"_34":35,"_148":217,"_149":85,"_36":218,"_38":159,"_65":66,"_151":219,"_67":24,"_153":-5,"_188":220,"_17":221},{"_32":205,"_13":206,"_62":207,"_42":208,"_34":35,"_148":209,"_149":85,"_36":210,"_38":26,"_65":66,"_151":211,"_67":24,"_153":-5,"_188":212,"_17":213},{"_32":198,"_13":199,"_62":200,"_42":-5,"_34":35,"_148":159,"_149":85,"_36":201,"_38":26,"_65":21,"_151":202,"_67":24,"_153":-5,"_188":203,"_17":204},{"_32":191,"_13":192,"_62":193,"_42":-5,"_34":35,"_148":111,"_149":85,"_36":194,"_38":159,"_65":21,"_151":195,"_67":24,"_153":-5,"_188":196,"_17":197},{"_32":183,"_13":184,"_62":83,"_42":-5,"_34":35,"_148":159,"_149":85,"_36":185,"_38":26,"_65":186,"_151":187,"_67":24,"_153":14,"_188":189,"_17":190},"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",[],[184],"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",[],[192],"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 · Metronome.tsx