`, 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\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",[],[182],"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",[],[191],["D",1788982490702],[],[18],"4176d6b1-694b-461c-9d28-c1d203a27440","verify-source.ts","38a28974-ac91-11f1-8a8e-1607ee4eb77e","493f8c8f-38c6-4527-824d-b38d0b671d71",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",[],[210,201],"tools","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",[],[210,212],"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",[],[210,220],"d38e9712-390b-4a27-97b3-5977c6b846a1",3,["D",1788987124028],"directory",[175,176,177],[210],"432ab789-595e-42c0-a785-c635f4f47067","root.tsx","01a087aa-7696-73e2-bbcf-6d2d8df7115a","01a087aa-7696-73e2-bbcf-711555ea69fb",["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

History · CHANGELOG.md