`, 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 {([\"signup\", \"login\"] as const).map((m) => (\n { setMode(m); setErr(\"\"); }}\n className={classNames(\n \"flex-1 py-2 cursor-pointer border-b-2\",\n mode === m ? \"border-[#c5b078] text-[#c5b078]\" : \"border-transparent text-[#6b7180]\",\n )}\n >\n {m === \"signup\" ? \"Registrati\" : \"Accedi\"}\n \n ))}\n

\n\n {mode === \"signup\" && (\n \n Nome utente\n setUsername(e.target.value)} maxLength={20}\n placeholder=\"es. nonna\" className={`${inputCls} mt-1`} />\n \n )}\n \n Email\n setEmail(e.target.value)}\n placeholder=\"tu@email.it\" className={`${inputCls} mt-1`} />\n \n \n Password\n setPassword(e.target.value)}\n placeholder=\"••••••\" className={`${inputCls} mt-1`} />\n \n\n {err &&

{err}

}\n \n

\n );\n}\n\n// ------------------------------------------------------------------ ChatDrawer\nfunction ChatDrawer({ me, friend, onClose }: { me: string; friend: string; onClose: () => void }) {\n const [messages, setMessages] = useState([]);\n const [text, setText] = useState(\"\");\n const last = useRef(0);\n const box = useRef(null);\n\n useEffect(() => {\n let stopped = false;\n let timer: number | undefined;\n (async function poll() {\n const res = await api.chat(friend, last.current);\n if (stopped || !res) return;\n if (res.messages.length) {\n last.current = res.messages[res.messages.length - 1].id;\n setMessages((m) => [...m, ...res.messages]);\n box.current?.scrollTo({ top: 1e9 });\n }\n timer = setTimeout(poll, 1500);\n })();\n return () => { stopped = true; if (timer) clearTimeout(timer); };\n }, [friend]);\n\n return (\n

\n 💬 @{friend}\n \n

\n {messages.length === 0 &&

Ancora nessun messaggio.

}\n {messages.map((m) => (\n

\n \n {m.text}\n \n

\n ))}\n

\n setText(e.target.value)}\n onKeyDown={(e) => { if (e.key === \"Enter\" && text.trim()) { api.sendChat(friend, text.trim()); setText(\"\"); } }}\n placeholder=\"Scrivi…\" className={`${inputCls} flex-1`} />\n { if (text.trim()) { api.sendChat(friend, text.trim()); setText(\"\"); } }}\n className=\"rounded-lg bg-[#2a2f3c] hover:bg-[#363c4c] px-3 cursor-pointer\"\n >➤\n

\n );\n}\n\n// ------------------------------------------------------------------ SocialPanel\nexport function SocialPanel({\n account,\n onLogout,\n onJoinRoom,\n onClose,\n}: {\n account: Account;\n onLogout: () => void;\n onJoinRoom: (roomId: string, notifId: number) => void;\n onClose: () => void;\n}) {\n const [friends, setFriends] = useState([]);\n const [invites, setInvites] = useState([]);\n const [addId, setAddId] = useState(\"\");\n const [err, setErr] = useState(\"\");\n const [chatWith, setChatWith] = useState(null);\n const lastNotif = useRef(0);\n\n async function refresh() {\n const f = await api.friends();\n if (f) setFriends(f.friends);\n const n = await api.notifications(lastNotif.current);\n if (n && n.notifications.length) {\n lastNotif.current = n.notifications[n.notifications.length - 1].id;\n setInvites((prev) => [\n ...prev,\n ...n.notifications.filter((x) => !prev.some((p) => p.id === x.id)),\n ]);\n }\n }\n\n useEffect(() => {\n refresh();\n const iv = setInterval(refresh, 5000);\n return () => clearInterval(iv);\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, []);\n\n return (\n

\n e.stopPropagation()}\n >\n

\n 👥 Amici & Inviti\n \n

\n\n {/* invites */}\n

Inviti alle stanze

\n {invites.length === 0 &&

Nessun invito.

}\n {invites.map((n) => (\n

\n @{n.data.from} ha aperto una stanza!\n onJoinRoom(n.data.roomId, n.id)}\n className=\"block mt-2 w-full rounded-lg bg-[#ff6b5e] hover:bg-[#ff5a4f] text-white font-bold py-2 cursor-pointer\"\n >\n Vuoi entrarci senza codice? Clicca qui →\n \n

\n ))}\n

\n\n {/* friends + add */}\n

I tuoi amici

\n {friends.length === 0 &&

Aggiungi amici con il loro @username.

}\n

\n {friends.map((f) => (\n

\n \n { api.removeFriend(f.username); setFriends((fs) => fs.filter((x) => x.username !== f.username)); }}\n className=\"text-[#6b7180] hover:text-[#ff6b5e] cursor-pointer text-xs\"\n title=\"Rimuovi\"\n >🗑\n

\n ))}\n

\n setAddId(e.target.value)}\n placeholder=\"username o email\" className={`${inputCls} flex-1`} />\n {\n setErr(\"\");\n const res = await api.addFriend(addId);\n if (res && (res as { error?: string }).error) setErr((res as { error: string }).error);\n else setAddId(\"\");\n await refresh();\n }}\n className=\"rounded-lg bg-[#2a2f3c] hover:bg-[#363c4c] px-3 cursor-pointer text-xs\"\n >+ Amico\n

\n {err &&

{err}

}\n

\n\n {/* chat */}\n {chatWith && setChatWith(null)} />}\n\n

\n Ciao @{account.username} 👋\n \n

\n \n );\n}\n\n// ------------------------------------------------------------------ InviteToasts\nexport function InviteToasts({\n invites,\n onJoinRoom,\n onDismiss,\n}: {\n invites: Notification[];\n onJoinRoom: (roomId: string, notifId: number) => void;\n onDismiss: (id: number) => void;\n}) {\n return (\n

\n {invites.map((n) => (\n

\n @{n.data.from} ha aperto una stanza! 🍝\n

\n onJoinRoom(n.data.roomId, n.id)}\n className=\"mt-2 w-full rounded-lg bg-[#ff6b5e] hover:bg-[#ff5a4f] text-white font-bold py-2 cursor-pointer\"\n >\n Vuoi entrarci senza codice? Clicca qui →\n \n \n

\n ))}\n

\n );\n}\n","label",[156,157,64],"frontend","components","pulls","branches",1,"forks","envVars",{"_166":160,"_168":26},"connections",{"_166":26,"_167":26},"count","unfilledCount","emptyCount",{"_32":335,"_13":156,"_62":266,"_42":-5,"_34":35,"_149":160,"_150":85,"_36":336,"_38":26,"_65":260,"_152":-5,"_67":24,"_154":-5,"_196":337,"_17":338},{"_32":331,"_13":157,"_62":148,"_42":266,"_34":35,"_149":160,"_150":85,"_36":332,"_38":26,"_65":260,"_152":-5,"_67":24,"_154":-5,"_196":333,"_17":334},{"_32":322,"_13":323,"_62":324,"_42":148,"_34":35,"_149":325,"_150":85,"_36":326,"_38":327,"_65":66,"_152":328,"_67":24,"_154":-5,"_196":329,"_17":330},{"_32":313,"_13":314,"_62":315,"_42":148,"_34":35,"_149":316,"_150":85,"_36":317,"_38":318,"_65":66,"_152":319,"_67":24,"_154":-5,"_196":320,"_17":321},{"_32":305,"_13":306,"_62":307,"_42":148,"_34":35,"_149":308,"_150":85,"_36":309,"_38":220,"_65":66,"_152":310,"_67":24,"_154":-5,"_196":311,"_17":312},{"_32":147,"_13":64,"_62":63,"_42":148,"_34":35,"_149":39,"_150":85,"_36":302,"_38":26,"_65":66,"_152":153,"_67":24,"_154":-5,"_196":303,"_17":304},{"_32":294,"_13":295,"_62":296,"_42":266,"_34":35,"_149":297,"_150":85,"_36":298,"_38":220,"_65":66,"_152":299,"_67":24,"_154":-5,"_196":300,"_17":301},{"_32":286,"_13":287,"_62":288,"_42":266,"_34":35,"_149":289,"_150":85,"_36":290,"_38":26,"_65":66,"_152":291,"_67":24,"_154":-5,"_196":292,"_17":293},{"_32":279,"_13":280,"_62":281,"_42":266,"_34":35,"_149":160,"_150":85,"_36":282,"_38":26,"_65":21,"_152":283,"_67":24,"_154":-5,"_196":284,"_17":285},{"_32":272,"_13":273,"_62":274,"_42":266,"_34":35,"_149":160,"_150":85,"_36":275,"_38":26,"_65":66,"_152":276,"_67":24,"_154":-5,"_196":277,"_17":278},{"_32":263,"_13":264,"_62":265,"_42":266,"_34":35,"_149":267,"_150":85,"_36":268,"_38":160,"_65":66,"_152":269,"_67":24,"_154":-5,"_196":270,"_17":271},{"_32":258,"_13":224,"_62":217,"_42":-5,"_34":35,"_149":220,"_150":85,"_36":259,"_38":26,"_65":260,"_152":-5,"_67":24,"_154":-5,"_196":261,"_17":262},{"_32":250,"_13":251,"_62":252,"_42":217,"_34":35,"_149":253,"_150":85,"_36":254,"_38":160,"_65":66,"_152":255,"_67":24,"_154":-5,"_196":256,"_17":257},{"_32":242,"_13":243,"_62":244,"_42":217,"_34":35,"_149":245,"_150":85,"_36":246,"_38":160,"_65":66,"_152":247,"_67":24,"_154":-5,"_196":248,"_17":249},{"_32":234,"_13":235,"_62":236,"_42":217,"_34":35,"_149":237,"_150":85,"_36":238,"_38":160,"_65":66,"_152":239,"_67":24,"_154":-5,"_196":240,"_17":241},{"_32":225,"_13":226,"_62":227,"_42":217,"_34":35,"_149":228,"_150":85,"_36":229,"_38":230,"_65":66,"_152":231,"_67":24,"_154":-5,"_196":232,"_17":233},{"_32":214,"_13":215,"_62":216,"_42":217,"_34":35,"_149":218,"_150":85,"_36":219,"_38":220,"_65":66,"_152":221,"_67":24,"_154":-5,"_196":222,"_17":223},{"_32":207,"_13":208,"_62":209,"_42":-5,"_34":35,"_149":160,"_150":85,"_36":210,"_38":26,"_65":21,"_152":211,"_67":24,"_154":-5,"_196":212,"_17":213},{"_32":199,"_13":200,"_62":201,"_42":-5,"_34":35,"_149":202,"_150":85,"_36":203,"_38":160,"_65":21,"_152":204,"_67":24,"_154":-5,"_196":205,"_17":206},{"_32":189,"_13":190,"_62":83,"_42":-5,"_34":35,"_149":191,"_150":85,"_36":192,"_38":193,"_65":194,"_152":195,"_67":24,"_154":14,"_196":197,"_17":198},"676eae59-7d17-4794-be56-17797f1e1dc4","index.ts",40,["D",1787479248743],6,"http","import { parseVal, serveImmutableFile } from \"https://esm.town/v/std/utils/index.ts\";\nimport { Hono } from \"npm:hono\";\nimport { Root } from \"./frontend/root.tsx\";\nimport * as game from \"./lib/game.ts\";\nimport * as auth from \"./lib/auth.ts\";\n\nfunction bearer(c: { req: Request }): string | null {\n return c.req.header(\"Authorization\")?.replace(/^Bearer\\s+/i, \"\") ?? null;\n}\n\n/** Returns the username if the request is authenticated, else a 401 response. */\nasync function requireAuth(c: { json: (x: unknown, s?: number) => Response; req: Request }) {\n const username = await auth.currentUser(bearer(c));\n if (!username) return { username: null, denied: c.json({ error: \"Non autenticato\" }, 401) };\n return { username, denied: null };\n}\n\nconst app = new Hono();\n\n// ---- frontend -------------------------------------------------------------\n\napp.get(\"/\", (c) => c.html(Root()));\napp.get(\"/__immutable/*\", (c) => serveImmutableFile(c.req.path));\napp.get(\"/source\", (c) => c.redirect(parseVal().links.self.val));\n\n// ---- helpers ---------------------------------------------------------------\n\nasync function readJson(c: { req: Request }): Promise> {\n try {\n return await c.req.json();\n } catch {\n return {};\n }\n}\n\n/** Look up the room, run a mutator, and persist + return the freshest state. */\nasync function mutate(\n c: { json: (x: unknown, status?: number) => Response },\n roomId: string,\n fn: () => Promise,\n ok = 200,\n): Promise {\n const result = await fn();\n if (result === null || result === undefined) {\n return c.json({ error: \"Stanza non trovata o azione non consentita\" }, 404);\n }\n return c.json(result, ok);\n}\n\n// ---- API ------------------------------------------------------------------\n\napp.post(\"/api/room\", async (c) => {\n const { name } = await readJson(c);\n const user = await auth.currentUser(bearer(c));\n const state = await game.createRoom(String(name ?? \"\").slice(0, 24), user ?? undefined);\n if (user) await auth.notifyRoomInvites(user, state.id); // 🔔 avvisa gli amici\n return c.json({ state, selfId: state.players[0].id }, 201);\n});\n\napp.post(\"/api/room/join\", async (c) => {\n const { code, name } = await readJson(c);\n const user = await auth.currentUser(bearer(c));\n const state = await game.joinRoom(\n String(code ?? \"\"),\n String(name ?? \"\").slice(0, 24),\n user ?? undefined,\n );\n if (!state) return c.json({ error: \"Codice non trovato\" }, 404);\n const me = user\n ? (state.players.find((p) => p.userId === user) ?? state.players[0])\n : (state.players.filter((p) => p.name === String(name ?? \"\").trim()).at(-1) ??\n state.players[0]);\n return c.json({ state, selfId: me.id });\n});\n\n// Poll: returns snapshot + incremental events, and advances time-based phases.\napp.get(\"/api/room/:id\", async (c) => {\n const id = c.req.param(\"id\");\n const since = Number(c.req.query(\"since\") ?? 0) || 0;\n const snap = await game.tick(id, since);\n if (!snap) return c.json({ error: \"Stanza non trovata\" }, 404);\n return c.json(snap);\n});\n\n// Full plates with embedded images (for serving animation + late joiners).\napp.get(\"/api/room/:id/plates\", async (c) => {\n const id = c.req.param(\"id\");\n const state = await game.getRoom(id);\n if (!state) return c.json({ error: \"Stanza non trovata\" }, 404);\n return c.json({ plates: game.getPlates(state) });\n});\n\napp.post(\"/api/room/:id/start\", async (c) => {\n const id = c.req.param(\"id\");\n return mutate(c, id, () => game.startDinner(id));\n});\n\napp.post(\"/api/room/:id/order\", async (c) => {\n const id = c.req.param(\"id\");\n const { player, orderText } = await readJson(c);\n return mutate(c, id, () =>\n game.placeOrder(id, String(player ?? \"\"), String(orderText ?? \"\")));\n});\n\napp.post(\"/api/room/:id/eat\", async (c) => {\n const id = c.req.param(\"id\");\n const { player } = await readJson(c);\n return mutate(c, id, () => game.eat(id, String(player ?? \"\")));\n});\n\napp.post(\"/api/room/:id/throw\", async (c) => {\n const id = c.req.param(\"id\");\n const { player, target } = await readJson(c);\n const t = target as { type?: string; playerId?: string };\n const parsed =\n t?.type === \"player\" && t.playerId\n ? { type: \"player\", playerId: t.playerId } as const\n : { type: \"waiter\" } as const;\n return mutate(c, id, () => game.throwFood(id, String(player ?? \"\"), parsed));\n});\n\napp.post(\"/api/room/:id/respond\", async (c) => {\n const id = c.req.param(\"id\");\n const { player, choice } = await readJson(c);\n const ch = choice === \"retaliate\" ? \"retaliate\" : \"peace\";\n return mutate(c, id, () => game.respond(id, String(player ?? \"\"), ch));\n});\n\napp.post(\"/api/room/:id/survive\", async (c) => {\n const id = c.req.param(\"id\");\n const { player, choice } = await readJson(c);\n return mutate(c, id, () =>\n game.survive(id, String(player ?? \"\"), String(choice ?? \"\")));\n});\n\n// -- serve a \"serving done\" fast-forward (client finished the animation) ----\napp.post(\"/api/room/:id/servingDone\", async (c) => {\n const id = c.req.param(\"id\");\n return mutate(c, id, async () => {\n const state = await game.getRoom(id);\n if (!state || state.phase !== \"serving\") return state;\n state.phase = \"chill\";\n await game.addEvent(id, \"SERVING_DONE\", {});\n await game.saveRoom(state);\n return state;\n });\n});\n\napp.onError((err) => Promise.reject(err));\n\n// ============================================================ ACCOUNTS =====\n\napp.post(\"/api/auth/signup\", async (c) => {\n const body = await readJson(c);\n const res = await auth.signup({\n username: String(body.username ?? \"\"),\n email: String(body.email ?? \"\"),\n password: String(body.password ?? \"\"),\n });\n if (res.error) return c.json(res, 400);\n return c.json(res, 201);\n});\n\napp.post(\"/api/auth/login\", async (c) => {\n const body = await readJson(c);\n const res = await auth.login({\n email: String(body.email ?? \"\"),\n password: String(body.password ?? \"\"),\n });\n if (res.error) return c.json(res, 401);\n return c.json(res);\n});\n\napp.post(\"/api/auth/logout\", async (c) => {\n await auth.logout(bearer(c));\n return c.json({ ok: true });\n});\n\napp.get(\"/api/me\", async (c) => {\n const username = await auth.currentUser(bearer(c));\n if (!username) return c.json({ error: \"Non autenticato\" }, 401);\n return c.json({ username });\n});\n\n// ============================================================ FRIENDS =======\n\napp.get(\"/api/friends\", async (c) => {\n const u = await requireAuth(c);\n if (u.denied) return u.denied;\n return c.json({ friends: await auth.listFriends(u.username) });\n});\n\napp.post(\"/api/friends\", async (c) => {\n const u = await requireAuth(c);\n if (u.denied) return u.denied;\n const { identifier } = await readJson(c);\n const res = await auth.addFriend(u.username, String(identifier ?? \"\"));\n if (res.error) return c.json(res, 400);\n return c.json({ ok: true });\n});\n\napp.delete(\"/api/friends/:username\", async (c) => {\n const u = await requireAuth(c);\n if (u.denied) return u.denied;\n await auth.removeFriend(u.username, c.req.param(\"username\"));\n return c.json({ ok: true });\n});\n\n// ============================================================ CHAT ==========\n\napp.get(\"/api/chat/:friend\", async (c) => {\n const u = await requireAuth(c);\n if (u.denied) return u.denied;\n const since = Number(c.req.query(\"since\") ?? 0) || 0;\n return c.json({ messages: await auth.getMessages(u.username, c.req.param(\"friend\"), since) });\n});\n\napp.post(\"/api/chat/:friend\", async (c) => {\n const u = await requireAuth(c);\n if (u.denied) return u.denied;\n const { text } = await readJson(c);\n const msg = await auth.sendMessage(u.username, c.req.param(\"friend\"), String(text ?? \"\"));\n if (!msg) return c.json({ error: \"Messaggio vuoto\" }, 400);\n return c.json({ message: msg });\n});\n\n// ======================================================= NOTIFICATIONS ======\n\napp.get(\"/api/notifications\", async (c) => {\n const u = await requireAuth(c);\n if (u.denied) return u.denied;\n const since = Number(c.req.query(\"since\") ?? 0) || 0;\n return c.json({ notifications: await auth.getNotifications(u.username, since) });\n});\n\n/** Accept a friend's room invite → join the room without any code. */\napp.post(\"/api/invite/:roomId\", async (c) => {\n const u = await requireAuth(c);\n if (u.denied) return u.denied;\n const { notifId } = await readJson(c);\n const roomId = c.req.param(\"roomId\");\n const state = await game.joinRoomById(roomId, u.username, u.username);\n if (!state) return c.json({ error: \"Stanza non trovata\" }, 404);\n if (notifId) await auth.markAccept(u.username, Number(notifId));\n const me = state.players.find((p) => p.userId === u.username) ?? state.players[0];\n return c.json({ state, selfId: me.id });\n});\n\nexport default app.fetch;\n","children",[],[190],"2eae2d98-92b1-4a8a-90b8-1c7756f1ffe5","README.md","01a02df6-016f-774c-911b-0f8a49cdb17a",20,["D",1787477879281],"# 🍝 Chaos Diner RPG\n\nUn'innocua cena al ristorante che si trasforma in un'arena di caos **multiplayer in tempo reale**, alimentata dall'**AI Cameriere** (Gemini).\n\n👉 **Gioca subito:** \n\n## 🎮 Come si gioca\n\n1. **Lobby** — un giocatore apre la stanza e condivide il codice con gli amici (ognuno entra da un proprio tab con **\"Entra\"**).\n2. **Ordinazione** — l'**AI Cameriere** ti dà il benvenuto e raccoglie l'ordine di ogni commensale, scritto in linguaggio naturale (es. *\"Cotoletta con patatine e una bibita\"*).\n3. **Servizio** — il Cameriere va in cucina, genera **l'immagine del piatto per ogni commensale** e torna con le pietanze **impilate una sopra l'altra**, distribuendole a ognuno in base a ciò che ha ordinato.\n4. **La scelta** — a ogni giocatore compare la forchetta con **🍴 Mangia Tranquillo** oppure **🍝 Lancia il Cibo**.\n5. **Food Fight & Fuga** — lanciare il cibo fa partire lo **scratch del vinile** e la traccia Heavy Metal. Bersaglia un commensale o il Cameriere: ogni lancio alimenta la sua **rabbia (0-100)**. Sopra la soglia, il Cameriere va in **RAGE** e parte la fase di **fuga**: nasconditi, scappa, lancia una sedia… chi viene beccato è **eliminato** e passa in modalità **Spettatore**. Sopravvive solo il più scaltro.\n\n## 🔧 Architettura (Val.town)\n\n```\nindex.ts ← server Hono: HTML + API\nlib/\n game.ts ← macchina a stati (LOBBY→ORDERING→SERVING→CHILL→CHASE→ENDED), rabbia, fuga\n ai.ts ← Cameriere AI (chat) + generazione immagini piatti (Gemini)\n db.ts ← SQLite (val-scoped): stanze + log eventi\n types.ts ← tipi condivisi client/server\nfrontend/\n root.tsx ← HTML shell\n audio.ts ← motore audio (scratch/metalli via Web Audio)\n api.ts ← client API + sessione (localStorage)\n components/ ← Lobby, GameScreen (tavolo, servizio, food fight, fuga)\n```\n\n- **Real-time**: polling (~1.2s) su `GET /api/room/:id?since=…` con eventi incrementali — serverless-friendly (niente WebSocket).\n- **Immagini piatti**: embeddate come data-URL negli eventi (`SERVING`), servite a ogni client; il polling resta leggero.\n- **Audio**: scratch del vinile e riff Heavy Metal generati in Web Audio (nessun asset esterno). Se vuoi colonne reali, punta due URL in `frontend/audio.ts` → `setPlaylist(lofiUrl, metalUrl)`.\n\n## ⚙️ Configurazione\n\nLa chiave **Gemini** vive nella env var `GEMINI_API_KEY` (mai nel codice). Modelli usati:\n- **Chat** (Cameriere): `gemini-3.5-flash` — attivo.\n- **Immagini** (piatti): `gemini-2.5-flash-image` — richiede **quota** sull'account (limite 0 sul piano free). Se non disponibile, il gioco usa un piatto segnaposto SVG come fallback.\n",[],[200],"d4196661-d5a3-44a8-9acb-9c96e3e22721","CHANGELOG.md","01a02df6-016f-774c-911b-0ba924477586",["D",1787477491994],"# 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 · Social.tsx