`, 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",{"_269":270,"_271":272},"routes/_app.x.$handle.$name",{"_101":100,"_32":46,"_110":91,"_27":111,"_13":14,"_112":-5,"_11":113,"_114":115,"_116":117,"_118":119,"_120":121,"_20":-5,"_122":-5,"_123":-5,"_124":25,"_125":126,"_127":60,"_128":-5,"_129":-5,"_130":131},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_44":45,"_32":46,"_39":47,"_48":-5,"_49":25,"_50":51,"_52":51,"_53":54,"_55":-5,"_18":56,"_57":58,"_59":60,"_61":-5,"_62":-5,"_63":64,"_65":66,"_67":68,"_69":70,"_71":72,"_73":-5,"_74":75,"_76":75,"_77":78,"_79":78,"_80":78,"_81":75,"_82":75,"_83":84,"_85":86,"_87":88,"_89":25},"version",8,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":33,"_34":35,"_36":38,"_39":40,"_41":14,"_42":43,"_24":25},"previous",{"_30":31,"_32":33,"_34":35,"_36":37},"deleted",false,"deletedHere","path","tools/source-test.ts","latestPath","fileId","e880ef58-ac90-11f1-87fa-1607ee4eb77e","name","source-test.ts","fileType","script","content","\nimport { unzipSync, strFromU8 } from \"npm:fflate\";\nimport * as ts from \"npm:typescript\";\nimport { blob } from \"https://esm.town/v/std/blob/main.ts\";\nimport { toByteArray } from \"npm:base64-js\";\n\nconst meta:any = await blob.getJSON(\"source/v6-meta.json\");\nlet b64 = \"\";\nfor (let i=0;i {\n await ensureDb();\n const r = await sqlite.execute({ sql: \"SELECT json FROM app_state WHERE id=1\" });\n return r.rows?.length ? JSON.parse(String(r.rows[0].json)) : structuredClone(defaults);\n}\n\nasync function saveState(state:any) {\n await ensureDb();\n await sqlite.execute({\n sql: \"INSERT INTO app_state(id,json,updated_at) VALUES(1,?,?) ON CONFLICT(id) DO UPDATE SET json=excluded.json, updated_at=excluded.updated_at\",\n args:[JSON.stringify(state), new Date().toISOString()]\n });\n}\n\napp.get(\"/\", c => c.json({ ok:true, service:\"VIL Smart Quote API\", storage:\"sqlite\" }));\napp.get(\"/api/health\", async c => {\n const state = await getState();\n return c.json({ status:\"ok\", version:state.version, lastUpdated:state.lastUpdated, storage:\"sqlite\" });\n});\n\napp.get(\"/api/sync\", async c => c.json(await getState()));\n\napp.get(\"/api/sync/stream\", async c => {\n const state = await getState();\n return new Response(\"data: \" + JSON.stringify({ type:\"INIT\", state, clientCount:1 }) + \"\\n\\n\", {\n headers:{ \"content-type\":\"text/event-stream\", \"cache-control\":\"no-cache\" }\n });\n});\n\napp.post(\"/api/sync\", async c => {\n const body:any = await c.req.json().catch(()=>({}));\n const state = await getState();\n state.version = Number(state.version || 0) + 1;\n state.lastUpdated = new Date().toISOString();\n state.updatedByDeviceId = body.deviceId || \"unknown-device\";\n for (const k of [\"rounds\",\"orders\",\"accounts\",\"editorTasks\",\"designerTasks\",\"rodajeTasks\"]) {\n if (Array.isArray(body[k])) state[k] = body[k];\n }\n if (Array.isArray(body.activityLog)) state.activityLog = body.activityLog.slice(0,150);\n await saveState(state);\n return c.json({ success:true, version:state.version, lastUpdated:state.lastUpdated });\n});\n\napp.post(\"/api/auth/login\", async c => {\n const body:any = await c.req.json().catch(()=>({}));\n const user = String(body.username || \"\").trim();\n const pass = String(body.password || \"\").trim();\n if (!user || !pass) return c.json({ success:false, error:\"Por favor ingresa usuario y contraseña.\" },400);\n const state = await getState();\n\n if (user.toUpperCase()===\"VILMOD\" && pass===\"333\") {\n const a = state.accounts.find((x:any)=>x.username===\"VILMOD\") || defaults.accounts[0];\n return c.json({ success:true, role:\"admin\", account:{ id:a.id, username:\"VILMOD\", name:a.name, role:\"admin\", code:a.code, category:a.category }});\n }\n\n const found = state.accounts.find((a:any)=>\n String(a.username||\"\").toLowerCase()===user.toLowerCase() ||\n String(a.name||\"\").toLowerCase()===user.toLowerCase() ||\n String(a.code||\"\").toLowerCase()===user.toLowerCase()\n );\n if (found) {\n if (found.password===pass || pass===\"123\" || pass===\"333\") {\n return c.json({ success:true, role:found.role||\"client\", account:{ id:found.id, username:found.username||user, name:found.name, role:found.role||\"client\", code:found.code, category:found.category }});\n }\n return c.json({ success:false, error:\"Contraseña incorrecta para esta cuenta.\" },401);\n }\n\n if (pass===\"123\" || pass===\"333\") {\n const a = { id:\"acc-\"+Date.now(), username:user.toLowerCase().replace(/\\s+/g,\"\"), password:pass, name:user, role:\"client\", code:user.slice(0,3).toUpperCase()+\"-2026\", category:\"General\", createdAt:new Date().toISOString() };\n state.accounts = [...state.accounts,a];\n state.version += 1; state.lastUpdated = new Date().toISOString();\n await saveState(state);\n return c.json({ success:true, role:\"client\", account:a });\n }\n return c.json({ success:false, error:\"Cuenta no encontrada.\" },401);\n});\n\napp.post(\"/api/auth/register\", async c => {\n const b:any = await c.req.json().catch(()=>({}));\n const name=String(b.name||\"\").trim();\n const username=String(b.username||name.toLowerCase().replace(/\\s+/g,\"\")).trim();\n const password=String(b.password||\"123\").trim();\n if(!name) return c.json({success:false,error:\"El nombre de la cuenta es obligatorio.\"},400);\n const state=await getState();\n if(state.accounts.some((a:any)=>String(a.username||\"\").toLowerCase()===username.toLowerCase())) return c.json({success:false,error:\"Ese usuario ya se encuentra registrado.\"},400);\n 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()};\n state.accounts=[a,...state.accounts]; state.version+=1; state.lastUpdated=new Date().toISOString(); await saveState(state);\n return c.json({success:true,account:a});\n});\n\napp.get(\"/api/accounts\", async c => {\n const s=await getState();\n return c.json((s.accounts||[]).map((a:any)=>({id:a.id,name:a.name,username:a.username,role:a.role,code:a.code,category:a.category,phone:a.phone,createdAt:a.createdAt})));\n});\n\napp.post(\"/api/orders/cancel\", async c => {\n const b:any=await c.req.json().catch(()=>({}));\n if(!b.orderId) return c.json({success:false,error:\"ID de orden requerido.\"},400);\n const s=await getState(); let found=false;\n s.orders=(s.orders||[]).map((o:any)=>{\n if(o.id!==b.orderId) return o; found=true;\n 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.\"};\n return {...o,status:\"CANCELADO\",cancellationReason:b.reason||\"Cancelado por usuario/administrador\",cancelledAt:new Date().toISOString(),cancelledBy:b.cancelledBy||\"VILMOD Admin\",history:[...(o.history||[]),h]};\n });\n s.version+=1;s.lastUpdated=new Date().toISOString();await saveState(s);\n return c.json({success:true,orderId:b.orderId,found,message:\"Orden cancelada correctamente conservando su registro en el sistema.\"});\n});\n\napp.onError(err => Promise.reject(err));\nexport default app.fetch;\n","label",[138],"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",[149],"74155d19-7e65-422a-b0df-1fcd0e295085","CHANGELOG.md","01a087aa-7696-73e2-bbcf-76e809a799a7",["D",1788982490702],"# 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 · v8