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

[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_287":288,"_289":290},"routes/_app.x.$handle.$name",{"_107":106,"_38":52,"_115":94,"_33":116,"_13":14,"_117":-5,"_11":118,"_119":120,"_121":122,"_123":124,"_125":126,"_26":-5,"_127":128,"_129":130,"_131":31,"_132":133,"_134":66,"_135":-5,"_136":-5,"_137":138},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":18,"_19":-5},"project",{"_50":51,"_38":52,"_45":53,"_54":-5,"_55":31,"_56":57,"_58":57,"_59":60,"_61":-5,"_19":62,"_63":64,"_65":66,"_67":-5,"_68":-5,"_69":70,"_71":72,"_73":-5,"_74":-5,"_75":-5,"_76":-5,"_77":78,"_79":78,"_80":81,"_82":81,"_83":81,"_84":78,"_85":78,"_86":87,"_88":89,"_90":91,"_92":31},"version",5,"changes",[25],"aiChatInfo",{"_20":21,"_22":-5,"_23":-5,"_24":-5},"userId","aiChatMessageId","1d05e4b3-5118-43d2-b473-e23a8d22f197","aiChatThreadId","aiChatThreadUserId","aiChatThreadTitle",{"_26":27,"_28":29,"_30":31,"_32":31,"_33":34,"_35":34},"file",{"_36":37,"_38":39,"_40":41,"_42":44,"_45":46,"_47":14,"_48":49,"_30":31},"previous",{"_36":37,"_38":39,"_40":41,"_42":43},"deleted",false,"deletedHere","path","frontend/components/Intro.tsx","latestPath","fileId","01a02707-526c-775c-b051-de0e0d4bd9cd","name","Intro.tsx","fileType","script","content","/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { AnimatePresence, motion } from \"https://esm.sh/framer-motion@11.0.3?deps=react@18.2.0,react-dom@18.2.0\";\nimport { Pet } from \"./Pet.tsx\";\nimport { Guitar, MusicNotes, Poster } from \"./Decor.tsx\";\n\ntype IntroProps = {\n tickled: boolean;\n onTickle: () => void;\n};\n\nconst HEARTS = [\"💙\", \"💜\", \"💖\", \"🖤\", \"💙\", \"💜\"];\n\nexport function Intro({ tickled, onTickle }: IntroProps) {\n return (\n

\n {/* floating hearts */}\n {!tickled &&\n HEARTS.map((h, i) => (\n \n {h}\n \n ))}\n\n {/* ambient music notes */}\n \n\n {/* wall of posters (frame the top) */}\n \n\n {/* guitar leaning on the left side */}\n \n\n {/* title */}\n \n \n Happy One Month\n

\n \n A ♥ A\n \n \n to my very special programmer smart gf 💙\n \n {/* the cheeky line */}\n \n i learned two things about coding.. thought id impress you.. kinda\n \n \n\n {/* the couple */}\n \n

\n \n

\n\n \n 💙\n \n \n\n {/* tickle reaction + hint */}\n \n {tickled ? (\n \n \n hehehe! giggle giggle\n \n

\n your letter is opening..\n

\n {Array.from({ length: 12 }).map((_, i) => (\n \n {[\"💙\", \"💜\", \"💖\", \"🖤\", \"✨\"][i % 5]}\n \n ))}\n \n ) : (\n \n \n tickle our belly to open ur letter..\n \n \n 👇\n \n \n )}\n \n \n );\n}\n","/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { AnimatePresence, motion } from \"https://esm.sh/framer-motion@11.0.3?deps=react@18.2.0,react-dom@18.2.0\";\nimport { Pet } from \"./Pet.tsx\";\nimport { Guitar, MusicNotes, Poster } from \"./Decor.tsx\";\n\ntype IntroProps = {\n tickled: boolean;\n onTickle: () => void;\n};\n\nconst HEARTS = [\"💙\", \"💜\", \"💖\", \"🖤\", \"💙\", \"💜\"];\n\nexport function Intro({ tickled, onTickle }: IntroProps) {\n return (\n

\n \n

\n\n \n 💙\n \n \n\n {/* tickle reaction + hint */}\n \n {tickled ? (\n \n \n hehehe! giggle giggle\n \n

\n your letter is opening..\n

\n {Array.from({ length: 12 }).map((_, i) => (\n \n {[\"💙\", \"💜\", \"💖\", \"🖤\", \"💙\"][i % 5]}\n \n ))}\n \n ) : (\n \n \n tickle our belly to open ur letter..\n \n \n 👇\n \n \n )}\n \n \n );\n}\n","createdAt",["D",1787361321936],"branchVersion","branchId","1421e029-8c7b-4344-b715-69e8fe910514","id","9ca6c30c-788a-49d6-b688-a90c81162074","happy-one-monthh",["D",1787361186298],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","Pastel kawaii bunny and puppy love val","imageUrl","019c48b9-aef2-748f-abf8-2c939a5819ab","pinnedFileId","01a02707-526d-758b-acbc-b4f6474fe754","pinPreview",true,"pinMigrated","screenshotVersion","likeCount",0,"orgId","019c48b9-aef2-748f-abf8-31845aa4b0c2","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_107":106,"_114":110},"org",{"_107":106,"_108":-5,"_109":110,"_19":62,"_111":112,"_113":31},"branch",{"_13":93,"_38":94,"_50":49,"_95":51,"_96":97,"_98":99,"_100":57,"_101":102,"_103":72,"_104":52,"_105":106},"isOwned",8,"main","projectId","forkedBranchId","b80d4a8f-ecfc-4841-8045-30dbe3cf6ed7","forkedBranchVersion",1,"forkedProjectPrivacy","forkedProjectId","05c4748c-cf74-4f40-9dbb-267fa01d08d8","forkedProjectOrgId","projectName","userHandle","aishaidk12","handle","displayName","avatar","https://img.clerk.com/eyJ0eXBlIjoiZGVmYXVsdCIsImlpZCI6Imluc18yTm10cGhQUklwU0tqZHNiOHNnNGd2ZjJURFUiLCJyaWQiOiJ1c2VyXzM5VU5LTGxnakJHdVRUaGgzejVJZmhoZVRUaiJ9","tier","free","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_50":51,"_38":52,"_45":283,"_54":-5,"_55":31,"_56":57,"_58":57,"_59":60,"_61":-5,"_19":62,"_63":64,"_65":66,"_67":-5,"_68":-5,"_69":70,"_71":72,"_73":-5,"_74":-5,"_75":-5,"_76":-5,"_77":78,"_79":78,"_80":81,"_82":81,"_83":81,"_84":78,"_85":78,"_86":284,"_88":285,"_90":286,"_92":31},"tree",[189,200,201,202],"files",[189,190,191,192,193,194,195,196,197,198,199,200,201,202],"counts",{"_179":70,"_180":99,"_181":70,"_182":183,"_184":185},"contents",[148,149,150,151],"upstreamProject",{"_50":102,"_38":146,"_59":60,"_61":-5,"_56":57,"_86":147},"upstreamBranch",{"_50":97,"_45":139,"_140":141,"_38":94,"_95":102,"_13":99,"_96":142,"_98":143,"_144":145,"_54":-5,"_92":31,"_56":57,"_105":106,"_71":72,"_104":146},"emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},["D",1787361078861],"updatedAt",["D",1787361078861],"0fa28226-ae82-45f8-84af-48b0c289215e",29,"lockfileKey","1787361081403-esm.town_v_aishaidk12_happy-one-monthyy@1-main","happy-one-monthyy",{"_107":106,"_114":110},{"_50":173,"_38":174,"_36":175,"_154":-5,"_48":49,"_47":99,"_155":66,"_45":176,"_13":70,"_40":177,"_42":-5,"_30":31,"_159":-5,"_33":178},{"_50":167,"_38":168,"_36":169,"_154":-5,"_48":49,"_47":99,"_155":66,"_45":170,"_13":70,"_40":26,"_42":171,"_30":31,"_159":-5,"_33":172},{"_50":161,"_38":162,"_36":163,"_154":-5,"_48":49,"_47":99,"_155":66,"_45":164,"_13":70,"_40":26,"_42":165,"_30":31,"_159":-5,"_33":166},{"_50":152,"_38":153,"_36":64,"_154":-5,"_48":49,"_47":99,"_155":66,"_45":156,"_13":70,"_40":157,"_42":158,"_30":31,"_159":-5,"_33":160},"59d3ad3a-e192-49a8-b583-6ce9c8ef8236","index.ts","parentId","latest",["D",1787361186298],"http","import { 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// 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","label",[153],"723f749f-3408-4827-a4e7-45e714c3185c","README.md","01a02707-526d-758b-acbc-b2bc82caac9a",["D",1787361186298],"# Happy One Month A&A 💕\n\nA pastel kawaii love page: a cute **bunny 🐰 and puppy 🐶** couple, a\n**\"Happy One Month\"** message, and a secret **tickle-to-letter** moment.\n\n## How it works\n\n1. **Intro screen** — the bunny & puppy bob and wiggle on a soft pink/lavender\n gradient, with floating hearts and the message *\"Happy One Month A & A — to\n the best gf ever.\"*\n2. **Tickle the belly** — click either pet's belly and they giggle, shake, and\n shower hearts, then it glides into…\n3. **The letter** — a fluffy paper with `Dear A,` and a big space to write.\n Typing **auto-saves** to the device (localStorage), so the letter is still\n there next time. \"Seal it with a kiss 💋\" tucks it away.\n\n## Stack\n\n- React 18 + Framer Motion (client-side, no build step)\n- Hono server serving the HTML shell\n- Twind (Tailwind utility classes) + Google Fonts (Baloo 2, Caveat)\n- All characters are hand-drawn **inline SVG** — no external images\n\n## Files\n\n```\nindex.ts ← Hono server (serves shell + assets)\nfrontend/\n root.tsx ← HTML shell (fonts, title, favicon)\n favicon.svg ← heart icon\n index.tsx ← React entrypoint\n components/\n App.tsx ← screen flow + background\n Intro.tsx ← the couple + \"happy one month\" + tickle\n Pet.tsx ← the bunny & puppy SVG characters\n Letter.tsx ← the letter-writing page\n```\n\n## Want to tweak?\n\n- **Names / message** — edit `Intro.tsx`.\n- **Colors** — the gradient lives in `App.tsx`; character colors in `Pet.tsx`.\n- **Letter storage** — currently stored per-device in localStorage. To save it\n server-side instead, add a small API route in `index.ts` + a `sqlite` import.\n",[162],"0a625d57-ba51-4b07-802b-bff12729043c","CHANGELOG.md","01a02707-526d-758b-acbc-ae1f1b206472",["D",1787361186298],"# 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

Diff · v5