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":16,"_18":19,"_17":-7,"_229":-5,"_20":230,"_22":231,"_232":233,"_234":235,"_26":236,"_24":237,"_238":-5,"_239":-5,"_240":54,"_241":242,"_243":45,"_244":-5,"_245":-5,"_246":247},"routes/_app.x.$handle.$name.branch.$branch.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","frontend/root.tsx","project",{"_33":171,"_13":14,"_46":172,"_173":-5,"_174":54,"_175":176,"_177":176,"_178":179,"_180":-5,"_181":182,"_183":65,"_184":45,"_185":-5,"_186":-5,"_187":48,"_188":189,"_190":191,"_192":193,"_194":195,"_196":-5,"_197":198,"_199":198,"_200":201,"_202":201,"_203":201,"_204":198,"_205":198,"_206":207,"_208":209,"_210":211,"_212":54},"tree",[58,59,60,61,62],"file",{"_33":34,"_13":35,"_36":37,"_38":39,"_40":41,"_42":43,"_44":45,"_46":47,"_17":48,"_49":50,"_51":52,"_53":54,"_55":-5,"_18":56},"contents",[],"upstream","pull","ahead","behind","envVars","id","432ab789-595e-42c0-a785-c635f4f47067","root.tsx","fileId","01a087aa-7696-73e2-bbcf-6d2d8df7115a","parentId","01a087aa-7696-73e2-bbcf-711555ea69fb","branchId","3219298f-8323-4d64-949f-85e34a93c66a","branchVersion",1,"latest",true,"createdAt",["D",1788982490702],0,"fileType","script","content","/** @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 \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","children",[],[64],"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",[],[75],"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