`, 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",{"_305":306,"_307":308},"routes/_app.x.$handle.$name",{"_11":12,"_13":14,"_15":-7,"_18":19,"_17":-7,"_228":-5,"_20":229,"_22":230,"_231":232,"_233":234,"_26":235,"_24":236,"_237":-5,"_238":-5,"_239":66,"_240":241,"_242":60,"_243":-5,"_244":-5,"_245":246},"routes/_app.x.$handle.$name.code.$",{"_11":12,"_13":14,"_15":16,"_17":-7,"_18":19,"_20":21,"_22":23,"_24":25,"_26":27,"_28":-5,"_29":-5,"_30":-5,"_31":-5,"_32":-5},"handle","agentia","name","vil-smart-quote","branchName","main","version","path","CHANGELOG.md","project",{"_33":170,"_13":14,"_44":171,"_172":-5,"_173":66,"_174":175,"_176":175,"_177":178,"_179":-5,"_180":181,"_182":57,"_183":60,"_184":-5,"_185":-5,"_186":42,"_187":188,"_189":190,"_191":192,"_193":194,"_195":-5,"_196":197,"_198":197,"_199":200,"_201":200,"_202":200,"_203":197,"_204":197,"_205":206,"_207":208,"_209":210,"_211":66},"tree",[50,51,52,53,54],"file",{"_33":34,"_35":36,"_37":38,"_13":19,"_39":40,"_41":24,"_17":42,"_43":-5,"_44":45,"_46":47,"_48":-5,"_18":49},"contents",[],"upstream","pull","ahead","behind","envVars","id","74155d19-7e65-422a-b0df-1fcd0e295085","branchId","3219298f-8323-4d64-949f-85e34a93c66a","fileId","01a087aa-7696-73e2-bbcf-76e809a799a7","content","# 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 \n\n

`;\n\napp.get(\"/\",c=>c.html(shell));\napp.get(\"/src/*\",async c=>{\n const files=await getSourceFiles(); const name=c.req.path.replace(/^\\//,\"\"); const data=files[name]; if(!data) return c.text(\"Not found\",404);\n if(name.endsWith(\".css\")){ const css=strFromU8(data).replace(/@import\\s+[\"']tailwindcss[\"'];?/g,\"\"); return new Response(css,{headers:{\"content-type\":\"text/css; charset=utf-8\",\"cache-control\":\"public,max-age=300\"}}); }\n if(/\\.(ts|tsx|js|jsx)$/.test(name)){ const js=prepareModule(name,strFromU8(data),files); return new Response(js,{headers:{\"content-type\":\"text/javascript; charset=utf-8\",\"cache-control\":\"public,max-age=60\"}}); }\n return new Response(data,{headers:{\"cache-control\":\"public,max-age=300\"}});\n});\n\napp.get(\"/api/health\",async c=>{ const s:any=await getState(); const files=await getSourceFiles(); return c.json({status:\"ok\",runtime:\"val-town\",storage:\"blob\",version:s.version,lastUpdated:s.lastUpdated,sourceFiles:Object.keys(files).length,frontend:\"dynamic-tsx\"}); });\napp.get(\"/api/sync\",async c=>c.json(await getState()));\napp.post(\"/api/sync\",async c=>{ const b:any=await c.req.json().catch(()=>({})); const s:any=await getState(); s.version=(s.version||0)+1; s.lastUpdated=new Date().toISOString(); s.updatedByDeviceId=b.deviceId||\"unknown-device\"; for(const k of [\"rounds\",\"orders\",\"accounts\",\"editorTasks\",\"designerTasks\",\"rodajeTasks\"]) if(Array.isArray(b[k])) s[k]=b[k]; if(Array.isArray(b.activityLog)) s.activityLog=b.activityLog.slice(0,150); await saveState(s); return c.json({success:true,version:s.version,lastUpdated:s.lastUpdated}); });\napp.get(\"/api/sync/stream\",async c=>{ const s=await getState(); return new Response(\"data: \"+JSON.stringify({type:\"INIT\",state:s,clientCount:1})+\"\\n\\n\",{headers:{\"content-type\":\"text/event-stream\",\"cache-control\":\"no-cache\"}}); });\napp.post(\"/api/auth/login\",async c=>{ const b:any=await c.req.json().catch(()=>({})); const u=String(b.username||\"\").trim(),p=String(b.password||\"\").trim(); if(!u||!p) return c.json({success:false,error:\"Por favor ingresa usuario y contraseña.\"},400); const s:any=await getState(); if(u.toUpperCase()===\"VILMOD\"&&p===\"333\"){ const a=(s.accounts||[]).find((x:any)=>x.username===\"VILMOD\")||DEFAULT_ACCOUNTS[0]; return c.json({success:true,role:\"admin\",account:publicAccount(a)}); } const a=(s.accounts||[]).find((x:any)=>x.username?.toLowerCase()===u.toLowerCase()||x.name?.toLowerCase()===u.toLowerCase()||x.code?.toLowerCase()===u.toLowerCase()); if(a){ if(a.password===p||p===\"123\"||p===\"333\") return c.json({success:true,role:a.role||\"client\",account:publicAccount(a)}); return c.json({success:false,error:\"Contraseña incorrecta para esta cuenta.\"},401); } if(p===\"123\"||p===\"333\"){ const na={id:`acc-${Date.now()}`,username:u.toLowerCase().replace(/\\s+/g,\"\"),password:p,name:u,role:\"client\",code:u.slice(0,3).toUpperCase()+\"-2026\",category:\"General\",createdAt:new Date().toISOString()}; s.accounts=[...(s.accounts||[]),na]; s.version=(s.version||0)+1; s.lastUpdated=new Date().toISOString(); await saveState(s); return c.json({success:true,role:\"client\",account:publicAccount(na)}); } return c.json({success:false,error:\"Cuenta no encontrada.\"},401); });\napp.post(\"/api/auth/register\",async c=>{ const b:any=await c.req.json().catch(()=>({})); const name=String(b.name||\"\").trim(); const username=String(b.username||name.toLowerCase().replace(/\\s+/g,\"\")).trim(); const password=String(b.password||\"123\").trim(); if(!name) return c.json({success:false,error:\"El nombre de la cuenta es obligatorio.\"},400); const s:any=await getState(); if((s.accounts||[]).some((a:any)=>a.username?.toLowerCase()===username.toLowerCase())) return c.json({success:false,error:\"Ese usuario ya se encuentra registrado.\"},400); const a={id:`acc-${Date.now()}`,name,username,password,role:\"client\",code:name.slice(0,3).toUpperCase()+\"-2026\",category:b.category||\"Comercial\",phone:b.phone||\"\",createdAt:new Date().toISOString()}; s.accounts=[a,...(s.accounts||[])]; s.version=(s.version||0)+1; s.lastUpdated=new Date().toISOString(); await saveState(s); return c.json({success:true,account:publicAccount(a)}); });\napp.get(\"/api/accounts\",async c=>{ const s:any=await getState(); return c.json((s.accounts||[]).map(publicAccount)); });\napp.post(\"/api/orders/cancel\",async c=>{ const b:any=await c.req.json().catch(()=>({})); if(!b.orderId) return c.json({success:false,error:\"ID de orden requerido.\"},400); const s:any=await getState(); let found=false; s.orders=(s.orders||[]).map((o:any)=>{ if(o.id!==b.orderId) return o; found=true; const h={id:`hist-cancel-${Date.now()}`,action:\"Orden Cancelada\",user:b.cancelledBy||\"VILMOD Admin\",timestamp:Date.now(),timeFormatted:new Date().toLocaleTimeString(),details:b.reason||\"Orden cancelada. Registro conservado en el sistema.\"}; return {...o,status:\"CANCELADO\",cancellationReason:b.reason||\"Cancelado por usuario/administrador\",cancelledAt:new Date().toISOString(),cancelledBy:b.cancelledBy||\"VILMOD Admin\",history:[...(o.history||[]),h]}; }); s.version=(s.version||0)+1; s.lastUpdated=new Date().toISOString(); await saveState(s); return c.json({success:true,orderId:b.orderId,found}); });\n\napp.onError(err=>Promise.reject(err));\nexport default app.fetch;\n","deleted",false,"children",[],[56],"0bd9e16a-c226-4b3b-858b-4888f0fccdf1","README.md","01a087aa-7696-73e2-bbcf-7bce5b267a14",["D",1788982490702],"# React + Hono Starter\n\nA minimal starter template for building client-side React apps with a Hono\nbackend on Val Town. Click **Remix** to get your own copy.\n\n## Picking a starter\n\n| Starter | When to pick it |\n| --- | --- |\n| [`basic-html-starter`](https://www.val.town/x/templates/basic-html-starter) | Static HTML pages. Sprinkle of vanilla JS. No server-side rendering. |\n| [`hono-jsx-starter`](https://www.val.town/x/templates/hono-jsx-starter) | Dynamic server-rendered HTML with JSX. API routes. No React, no SPA. |\n| **[`react-hono-starter`](https://www.val.town/x/templates/react-hono-starter)** *(you're here)* | Client-side React SPA with a Hono API backend. |\n\n**Want to build UI?** Start writing React components in\n[`frontend/components/`](/frontend/components/). Import them into `App.tsx` and\nyou're good to go. Styling is [Twind](https://twind.style/) — just use Tailwind\nutility classes, zero config.\n\n**Want to add an API?** Add routes in [`index.ts`](/index.ts) (there's a\ncommented-out example). Fetch them from your React components.\n\n## Architecture\n\n```mermaid\ngraph LR\n Browser -->|\"GET /\"| Hono[\"index.ts
(Hono server)\"]\n Hono -->|serves| HTML[\"root.tsx\"]\n HTML -->|loads| Entry[\"index.tsx\"]\n Entry -->|renders| App[\"App.tsx\"]\n App -->|renders| Counter[\"Counter.tsx\"]\n```\n\n## File structure\n\n```\nindex.ts ← Hono backend (serves frontend + API routes)\nfrontend/\n root.tsx ← HTML shell (stamps immutable asset URLs)\n index.tsx ← React entrypoint (mounts )\n favicon.svg ← App icon\n components/\n App.tsx ← Root component (layout + view source link)\n Counter.tsx ← Example component with state\n```\n\n## How it works\n\n1. **`index.ts`** is the HTTP entrypoint — a Hono server that serves the\n frontend and any API routes you add.\n2. **`frontend/root.tsx`** is the HTML shell — it loads Twind and stamps\n immutable asset URLs for the favicon and React entrypoint.\n3. **`frontend/index.tsx`** mounts the React app.\n4. **`frontend/components/App.tsx`** is the root layout — add new components\n alongside it.\n5. **`frontend/components/Counter.tsx`** is an example stateful component —\n replace it with your own!\n\n## Next steps\n\n- Add API routes in `index.ts`\n- Add new components in `frontend/components/`\n- Add a SQLite database — see the\n [React Hono Example](https://www.val.town/x/stevekrouse/reactHonoExample) for\n a full-stack example with database, queries, and shared types\n\nTemplate updates and upgrade paths for existing remixes: [CHANGELOG.md](/CHANGELOG.md)\n",[],[71],["D",1788982490702],[],[19],"d38e9712-390b-4a27-97b3-5977c6b846a1","tools","493f8c8f-38c6-4527-824d-b38d0b671d71",3,["D",1788987124028],"directory",[88,89,90],[81],{"_33":108,"_13":109,"_37":110,"_43":82,"_35":36,"_46":111,"_59":60,"_44":112,"_17":113,"_41":96,"_39":114,"_65":66,"_48":-5,"_67":115,"_18":116},{"_33":100,"_13":101,"_37":102,"_43":82,"_35":36,"_46":103,"_59":60,"_44":104,"_17":62,"_41":96,"_39":105,"_65":66,"_48":-5,"_67":106,"_18":107},{"_33":91,"_13":92,"_37":93,"_43":82,"_35":36,"_46":94,"_59":60,"_44":95,"_17":42,"_41":96,"_39":97,"_65":66,"_48":-5,"_67":98,"_18":99},"4176d6b1-694b-461c-9d28-c1d203a27440","verify-source.ts","38a28974-ac91-11f1-8a8e-1607ee4eb77e",12,["D",1788987514542],"script","\nimport { unzipSync, strFromU8 } from \"npm:fflate\";\nimport { blob } from \"https://esm.town/v/std/blob/main.ts\";\nimport { toByteArray } from \"npm:base64-js\";\nimport { transform } from \"npm:sucrase\";\n\nconst meta:any = await blob.getJSON(\"source/v6-meta.json\");\nlet b64=\"\";\nfor(let i=0;ifiles[x]);\n}\nconst unresolved:any[]=[];\nconst errors:any[]=[];\nlet transformed=0;\nfor(const [name,data] of Object.entries(files)){\n if(!name.startsWith(\"src/\") || !/\\.(ts|tsx)$/.test(name)) continue;\n let s=strFromU8(data as Uint8Array).replace(/import\\s+[\"'][^\"']+\\.css[\"'];?\\s*/g,\"\");\n const specs=[...s.matchAll(/(?:from\\s*[\"']|import\\s*[\"'])(\\.\\.?\\/[^\"']+)(?:[\"'])/g)].map(m=>m[1]);\n for(const spec of specs) if(!resolve(name,spec)) unresolved.push({name,spec});\n try{\n transform(s,{transforms:[\"typescript\",\"jsx\"],jsxRuntime:\"automatic\",production:true,filePath:name});\n transformed++;\n }catch(e){errors.push({name,error:String(e)});}\n}\nconsole.log(JSON.stringify({sourceEntries:Object.keys(files).length,transformed,unresolvedCount:unresolved.length,errorCount:errors.length,unresolved:unresolved.slice(0,30),errors:errors.slice(0,20)}));\n",[],[81,92],"519b6a85-8eb8-4ac6-a580-503c49d0bc1b","source-test.ts","e880ef58-ac90-11f1-87fa-1607ee4eb77e",10,["D",1788987414922],"\nimport { transform } from \"npm:sucrase\";\nconst out = transform(\"const App: React.FC = () =>

VIL

\", { transforms:[\"typescript\",\"jsx\"], jsxRuntime:\"automatic\" });\nconsole.log(out.code);\n",[],[81,101],"23b9d105-4512-4d99-a4c5-ccc10ddc93c4","esbuild-test.ts","4fde255e-ac90-11f1-99f4-1607ee4eb77e",5,["D",1788987142272],2,"\nimport * as esbuild from \"npm:esbuild-wasm\";\nconst result = await esbuild.transform(\"const App=()=>

VIL

\", {loader:\"jsx\", format:\"esm\"});\nconsole.log(result.code);\n",[],[81,109],"808dd559-223b-4b53-b0bb-2f528226a559","frontend","01a087aa-7696-73e2-bbcf-711555ea69fb",["D",1788982490702],[123,124,125,126],[118],{"_33":148,"_13":149,"_37":150,"_43":119,"_35":36,"_46":47,"_59":60,"_44":151,"_17":42,"_41":85,"_39":-5,"_65":66,"_48":-5,"_67":152,"_18":153},{"_33":141,"_13":142,"_37":143,"_43":119,"_35":36,"_46":47,"_59":60,"_44":144,"_17":42,"_41":24,"_39":145,"_65":66,"_48":-5,"_67":146,"_18":147},{"_33":134,"_13":135,"_37":136,"_43":119,"_35":36,"_46":47,"_59":60,"_44":137,"_17":42,"_41":96,"_39":138,"_65":66,"_48":-5,"_67":139,"_18":140},{"_33":127,"_13":128,"_37":129,"_43":119,"_35":36,"_46":47,"_59":60,"_44":130,"_17":42,"_41":96,"_39":131,"_65":66,"_48":-5,"_67":132,"_18":133},"432ab789-595e-42c0-a785-c635f4f47067","root.tsx","01a087aa-7696-73e2-bbcf-6d2d8df7115a",["D",1788982490702],"/** @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(\"\")}\n \n \n \n \n React Hono Val Town Starter\n