`, 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",{"_260":261,"_262":263},"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",4,"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/esbuild-test.ts","latestPath","fileId","4fde255e-ac90-11f1-99f4-1607ee4eb77e","name","esbuild-test.ts","fileType","script","content","\nimport * as esbuild from \"npm:esbuild\";\nconst result = await esbuild.transform(\"const App=()=>

VIL

\", {loader:\"jsx\", format:\"esm\"});\nconsole.log(result.code);\n","\nimport * as esbuild from \"npm:esbuild-wasm\";\nawait esbuild.initialize({ wasmURL: \"https://unpkg.com/esbuild-wasm@0.25.0/esbuild.wasm\", worker: false });\nconst result = await esbuild.transform(\"const App=()=>

VIL

\", {loader:\"jsx\", format:\"esm\"});\nconsole.log(result.code);\n","createdAt",["D",1788987134150],"branchVersion","branchId","3219298f-8323-4d64-949f-85e34a93c66a","id","e3693f7c-c8ce-4f21-8668-20a693a331b6","vil-smart-quote",["D",1788982490702],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","VIL Smart Quote full-stack app","imageUrl","b162e777-26d5-4b57-b5d4-824de1b425e2","pinnedFileId","01a087aa-7696-73e2-bbcf-7f5951d0ccdc","pinPreview",true,"pinMigrated","screenshotVersion","likeCount",0,"orgId","01a087a7-039d-766a-a2cb-d9a1a861d44b","tursoName","e3693f7cc8ce4f21866820a693a331b6","tursoHostname","e3693f7cc8ce4f21866820a693a331b6-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789504908499],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_101":100,"_109":105},"org",{"_101":100,"_102":103,"_104":105,"_18":56,"_106":107,"_108":25},"branch",{"_13":90,"_32":91,"_44":43,"_92":45,"_93":-5,"_94":-5,"_95":-5,"_96":-5,"_97":-5,"_98":46,"_99":100},"isOwned",14,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","agentia","handle","displayName","Agent Ia","avatar","https://lh3.googleusercontent.com/a/ACg8ocJFdiW2REahwLO-JAErcTTOgHyYDVN6VBKDk9RmathkK-sumQ=s96-c","tier","free","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_44":45,"_32":46,"_39":255,"_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":256,"_73":-5,"_74":75,"_76":75,"_77":78,"_79":78,"_80":78,"_81":75,"_82":75,"_83":257,"_85":258,"_87":259,"_89":25},"tree",[182,189,191,192,193],"files",[182,183,184,185,186,187,188,189,190,191,192,193],"counts",{"_172":64,"_173":143,"_174":64,"_175":176,"_177":178},"contents",[132,133,134,135,136],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_44":167,"_32":168,"_30":169,"_139":-5,"_42":43,"_41":143,"_141":60,"_39":170,"_13":64,"_34":165,"_36":-5,"_24":25,"_146":-5,"_27":171},{"_44":160,"_32":161,"_30":162,"_139":-5,"_42":43,"_41":163,"_141":60,"_39":164,"_13":64,"_34":165,"_36":-5,"_24":25,"_146":-5,"_27":166},{"_44":154,"_32":155,"_30":156,"_139":-5,"_42":43,"_41":143,"_141":60,"_39":157,"_13":64,"_34":20,"_36":158,"_24":25,"_146":-5,"_27":159},{"_44":148,"_32":149,"_30":150,"_139":-5,"_42":43,"_41":143,"_141":60,"_39":151,"_13":64,"_34":20,"_36":152,"_24":25,"_146":-5,"_27":153},{"_44":137,"_32":138,"_30":58,"_139":-5,"_42":43,"_41":140,"_141":25,"_39":142,"_13":143,"_34":144,"_36":145,"_24":25,"_146":46,"_27":147},"9b2b2645-7fbe-446c-b84e-11eaa2c8460b","index.ts","parentId",2,"latest",["D",1788986807704],1,"http","\nimport { Hono } from \"npm:hono\";\nimport { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\n\nconst app = new Hono();\n\nconst defaults = {\n version: 1,\n lastUpdated: new Date().toISOString(),\n rounds: [],\n orders: [],\n accounts: [\n { id:\"acc-admin-vilmod\", username:\"VILMOD\", password:\"333\", name:\"VILMOD (Administrador)\", role:\"admin\", code:\"VIL-ADM\", category:\"Administración Central\", phone:\"+591 70000000\", createdAt:new Date().toISOString() },\n { id:\"acc-buenaventura-2026\", username:\"buenaventura\", password:\"123\", name:\"New Buena Aventura Suites 2026\", role:\"client\", code:\"BAS-2026\", category:\"Hoteles y Suites\", phone:\"+54 9 11 5566-7788\", createdAt:new Date().toISOString() },\n { id:\"acc-ferremaxxis-2026\", username:\"ferremaxxis\", password:\"123\", name:\"Ferremaxxis Ferreterias\", role:\"client\", code:\"FER-2026\", category:\"Comercial y Herramientas\", phone:\"+591 76543210\", createdAt:new Date().toISOString() }\n ],\n editorTasks: [], designerTasks: [], rodajeTasks: [], activityLog: []\n};\n\nasync function ensureDb() {\n await sqlite.execute({ sql: \"CREATE TABLE IF NOT EXISTS app_state (id INTEGER PRIMARY KEY CHECK(id=1), json TEXT NOT NULL, updated_at TEXT NOT NULL)\" });\n const row = await sqlite.execute({ sql: \"SELECT json FROM app_state WHERE id=1\" });\n if (!row.rows?.length) {\n await sqlite.execute({ sql: \"INSERT INTO app_state(id,json,updated_at) VALUES(1,?,?)\", args:[JSON.stringify(defaults), new Date().toISOString()] });\n }\n}\n\nasync function getState(): Promise {\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 · v4