`, 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":97,"_33":116,"_13":14,"_117":-5,"_11":118,"_119":120,"_121":122,"_123":124,"_125":126,"_26":-5,"_127":-5,"_128":-5,"_129":31,"_130":131,"_132":66,"_133":-5,"_134":-5,"_135":136},"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":74,"_75":76,"_77":78,"_79":-5,"_80":81,"_82":81,"_83":84,"_85":84,"_86":84,"_87":81,"_88":81,"_89":90,"_91":92,"_93":94,"_95":31},"version",20,"changes",[25],"aiChatInfo",{"_20":21,"_22":-5,"_23":-5,"_24":-5},"userId","aiChatMessageId","9303d6bb-ed32-40ef-ab77-62b3f76f2e92","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/Pet.tsx","latestPath","fileId","164edd56-9dc2-11f1-be5f-1607ee4eb77e","name","Pet.tsx","fileType","script","content","/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { motion } from \"https://esm.sh/framer-motion@11.0.3?deps=react@18.2.0,react-dom@18.2.0\";\n\ntype PetProps = {\n type: \"bunny\" | \"puppy\";\n tickled: boolean;\n onTickle: () => void;\n label?: string;\n};\n\n/**\n * A cute kawaii pet (bunny or puppy) drawn in inline SVG.\n * - Idle: gently bobs up and down (breathing) with wiggling ears.\n * - Tickled: shakes, giggles and showers hearts.\n * The whole pet is clickable, but the belly is the \"tickle spot\".\n */\nexport function Pet({ type, tickled, onTickle, label }: PetProps) {\n const isBunny = type === \"bunny\";\n return (\n \n \n {/* ears */}\n {isBunny ? : }\n {/* head */}\n \n {/* muzzle (puppy) */}\n {!isBunny && (\n \n )}\n {/* eyes */}\n \n \n \n \n {/* blush */}\n \n \n {/* nose */}\n {isBunny ? (\n \n ) : (\n \n )}\n {/* mouth */}\n {isBunny ? (\n \n ) : (\n \n )}\n {/* arms */}\n \n \n {/* body */}\n \n {/* belly — the tickle spot */}\n \n {/* feet */}\n \n \n \n\n {/* label */}\n {label && (\n

\n {label}\n

\n )}\n \n );\n}\n\nfunction BunnyEars() {\n return (\n <>\n \n \n \n \n \n \n \n \n \n );\n}\n\nfunction PuppyEars() {\n return (\n <>\n \n \n \n \n \n \n \n \n \n );\n}\n","/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport { motion } from \"https://esm.sh/framer-motion@11.0.3?deps=react@18.2.0,react-dom@18.2.0\";\n\ntype PetProps = {\n type: \"bunny\" | \"puppy\";\n tickled: boolean;\n onTickle: () => void;\n label?: string;\n};\n\n/**\n * A cute kawaii pet (bunny or puppy) drawn in inline SVG.\n * - Idle: gently bobs up and down (breathing) with wiggling ears.\n * - Tickled: shakes, giggles and showers hearts.\n * The whole pet is clickable, but the belly is the \"tickle spot\".\n */\nexport function Pet({ type, tickled, onTickle, label }: PetProps) {\n const isBunny = type === \"bunny\";\n return (\n \n {/* soft glow halo so the pale pets pop on the dark night bg */}\n \n \n \n \n {/* ears */}\n {isBunny ? : }\n {/* head */}\n \n {/* muzzle (puppy) */}\n {!isBunny && (\n \n )}\n {/* eyes */}\n \n \n \n \n {/* blush */}\n \n \n {/* nose */}\n {isBunny ? (\n \n ) : (\n \n )}\n {/* mouth */}\n {isBunny ? (\n \n ) : (\n \n )}\n {/* arms */}\n \n \n {/* body */}\n \n {/* belly — the tickle spot */}\n \n {/* feet */}\n \n \n \n\n {/* label */}\n {label && (\n

\n {label}\n

\n )}\n \n );\n}\n\nfunction BunnyEars() {\n return (\n <>\n \n \n \n \n \n \n \n \n \n );\n}\n\nfunction PuppyEars() {\n return (\n <>\n \n \n \n \n \n \n \n \n \n );\n}\n","createdAt",["D",1787360028579],"branchVersion","branchId","0fa28226-ae82-45f8-84af-48b0c289215e","id","5f698c9f-e512-4f53-81c6-041f8c803dd2","happy-one-month",["D",1787359217218],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","Pastel kawaii bunny and puppy love val","imageUrl","019c48b9-aef2-748f-abf8-2c939a5819ab","pinnedFileId","01a026e9-468f-724a-a4ff-d1ca0aed23f4","pinPreview",true,"pinMigrated","screenshotVersion","likeCount",0,"orgId","019c48b9-aef2-748f-abf8-31845aa4b0c2","tursoName","5f698c9fe5124f5381c6041f8c803dd2","tursoHostname","5f698c9fe5124f5381c6041f8c803dd2-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789532458193],"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":96,"_38":97,"_50":49,"_98":51,"_99":-5,"_100":-5,"_101":-5,"_102":-5,"_103":-5,"_104":52,"_105":106},"isOwned",29,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","aishaidk12","handle","displayName","avatar","https://img.clerk.com/eyJ0eXBlIjoiZGVmYXVsdCIsImlpZCI6Imluc18yTm10cGhQUklwU0tqZHNiOHNnNGd2ZjJURFUiLCJyaWQiOiJ1c2VyXzM5VU5LTGxnakJHdVRUaGgzejVJZmhoZVRUaiJ9","tier","free","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_50":51,"_38":52,"_45":282,"_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":74,"_75":76,"_77":283,"_79":-5,"_80":81,"_82":81,"_83":84,"_85":84,"_86":84,"_87":81,"_88":81,"_89":284,"_91":285,"_93":286,"_95":31},"tree",[180,191,192,193],"files",[180,181,182,183,184,185,186,187,188,189,190,191,192,193],"counts",{"_170":70,"_171":144,"_172":144,"_173":174,"_175":176},"contents",[137,138,139,140],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_50":164,"_38":165,"_36":166,"_143":-5,"_48":49,"_47":144,"_145":66,"_45":167,"_13":70,"_40":168,"_42":-5,"_30":31,"_149":-5,"_33":169},{"_50":158,"_38":159,"_36":160,"_143":-5,"_48":49,"_47":144,"_145":66,"_45":161,"_13":70,"_40":26,"_42":162,"_30":31,"_149":-5,"_33":163},{"_50":151,"_38":152,"_36":153,"_143":-5,"_48":49,"_47":154,"_145":66,"_45":155,"_13":144,"_40":26,"_42":156,"_30":31,"_149":-5,"_33":157},{"_50":141,"_38":142,"_36":64,"_143":-5,"_48":49,"_47":144,"_145":31,"_45":146,"_13":70,"_40":147,"_42":148,"_30":31,"_149":52,"_33":150},"6ac4d990-b6bb-497d-bb0a-f3242ce6e9cc","index.ts","parentId",1,"latest",["D",1787359217218],"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","label",[142],"7e94226e-53b8-46e2-b62b-e559d1cbc7b5","README.md","01a026e9-468f-724a-a4ff-cfac0f762338",9,["D",1787359302112],"# 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",[152],"22397111-e309-4088-b808-867f24f97bba","CHANGELOG.md","01a026e9-468f-724a-a4ff-c890c6c92ff4",["D",1787359217218],"# 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 · v20