`, 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 Clicked\n setCount((c) => c + 1)}\n class=\"bg-blue-500 hover:bg-blue-600 text-white font-medium px-4 py-2 rounded-lg transition-colors cursor-pointer\"\n >\n {count}\n \n times\n

\n );\n}\n","label",[319,320,69],"frontend","components","pulls","branches","forks","envVars",{"_328":26,"_330":26},"connections",{"_328":26,"_329":26},"count","unfilledCount","emptyCount",{"_32":405,"_13":319,"_67":368,"_42":-5,"_34":35,"_312":39,"_313":89,"_36":406,"_38":26,"_70":402,"_315":-5,"_72":24,"_317":-5,"_348":407,"_17":408},{"_32":400,"_13":320,"_67":311,"_42":368,"_34":35,"_312":39,"_313":89,"_36":401,"_38":26,"_70":402,"_315":-5,"_72":24,"_317":-5,"_348":403,"_17":404},{"_32":391,"_13":392,"_67":393,"_42":311,"_34":35,"_312":394,"_313":89,"_36":395,"_38":396,"_70":71,"_315":397,"_72":24,"_317":-5,"_348":398,"_17":399},{"_32":310,"_13":69,"_67":68,"_42":311,"_34":35,"_312":39,"_313":89,"_36":388,"_38":26,"_70":71,"_315":316,"_72":24,"_317":-5,"_348":389,"_17":390},{"_32":381,"_13":382,"_67":383,"_42":368,"_34":35,"_312":39,"_313":89,"_36":384,"_38":26,"_70":21,"_315":385,"_72":24,"_317":-5,"_348":386,"_17":387},{"_32":374,"_13":375,"_67":376,"_42":368,"_34":35,"_312":39,"_313":89,"_36":377,"_38":26,"_70":71,"_315":378,"_72":24,"_317":-5,"_348":379,"_17":380},{"_32":365,"_13":366,"_67":367,"_42":368,"_34":35,"_312":115,"_313":89,"_36":369,"_38":370,"_70":71,"_315":371,"_72":24,"_317":-5,"_348":372,"_17":373},{"_32":358,"_13":359,"_67":360,"_42":-5,"_34":35,"_312":39,"_313":89,"_36":361,"_38":26,"_70":21,"_315":362,"_72":24,"_317":-5,"_348":363,"_17":364},{"_32":351,"_13":352,"_67":353,"_42":-5,"_34":35,"_312":39,"_313":89,"_36":354,"_38":26,"_70":21,"_315":355,"_72":24,"_317":-5,"_348":356,"_17":357},{"_32":341,"_13":342,"_67":87,"_42":-5,"_34":35,"_312":343,"_313":89,"_36":344,"_38":345,"_70":346,"_315":347,"_72":24,"_317":-5,"_348":349,"_17":350},"728f2bf1-469a-41d9-a263-11104770ff8a","index.ts",83,["D",1787696741820],3,"http","import { parseVal, serveImmutableFile } from \"https://esm.town/v/std/utils/index.ts\";\nimport { sqlite as licenseDb } from \"https://esm.town/v/std/sqlite/global.ts\";\nimport { sqlite as appDb } from \"https://esm.town/v/std/sqlite/main.ts\";\nimport { Hono } from \"npm:hono\";\nimport { Root } from \"./frontend/root.tsx\";\n\nconst app = new Hono();\nawait appDb.execute(`CREATE TABLE IF NOT EXISTS tc_app_store (\n device_id TEXT NOT NULL,\n collection TEXT NOT NULL CHECK (collection IN ('products','sales','clients','suppliers','finance','business')),\n payload TEXT NOT NULL,\n updated_at TEXT NOT NULL,\n PRIMARY KEY (device_id, collection)\n)`);\nawait appDb.execute(`CREATE TABLE IF NOT EXISTS tc_app_access (\n device_id TEXT PRIMARY KEY,\n secret_hash TEXT NOT NULL,\n created_at TEXT NOT NULL,\n last_access_at TEXT NOT NULL\n)`);\nconst secretHash=async(value:string)=>Array.from(new Uint8Array(await crypto.subtle.digest(\"SHA-256\",new TextEncoder().encode(value)))).map(x=>x.toString(16).padStart(2,\"0\")).join(\"\");\nconst authorized=async(c:any,device:string)=>{\n const header=c.req.header(\"Authorization\")||\"\",token=header.startsWith(\"Bearer \")?header.slice(7):\"\";\n if(!device||token.length<40)return false;\n const q=await appDb.execute({sql:\"SELECT secret_hash FROM tc_app_access WHERE device_id=?\",args:[device]});\n if(!q.rows.length||q.rows[0].secret_hash!==await secretHash(token))return false;\n await appDb.execute({sql:\"UPDATE tc_app_access SET last_access_at=? WHERE device_id=?\",args:[new Date().toISOString(),device]});\n return true;\n};\nawait licenseDb.execute(`CREATE TABLE IF NOT EXISTS tc_licenses (\n license_key TEXT PRIMARY KEY, plan TEXT NOT NULL, customer TEXT, created_at TEXT NOT NULL,\n activated_at TEXT, expires_at TEXT, device_id TEXT, active INTEGER NOT NULL DEFAULT 1\n)`);\nawait licenseDb.execute(`CREATE TABLE IF NOT EXISTS tc_trials (\n device_id TEXT PRIMARY KEY, started_at TEXT NOT NULL, expires_at TEXT NOT NULL\n)`);\n\nconst daysFor=(plan:string)=>({semanal:7,mensual:30,semestral:182,anual:365}[plan]||30);\nconst state=async(device:string)=>{\n if(!device) return {active:false,status:\"device_required\"};\n const l=await licenseDb.execute({sql:\"SELECT license_key,plan,customer,expires_at FROM tc_licenses WHERE device_id=? AND active=1 AND expires_at>?\",args:[device,new Date().toISOString()]});\n if(l.rows.length) return {active:true,status:\"licensed\",...l.rows[0]};\n let t=await licenseDb.execute({sql:\"SELECT * FROM tc_trials WHERE device_id=?\",args:[device]});\n if(!t.rows.length){\n const now=new Date(),expires=new Date(now.getTime()+5*86400000);\n await licenseDb.execute({sql:\"INSERT INTO tc_trials(device_id,started_at,expires_at) VALUES(?,?,?)\",args:[device,now.toISOString(),expires.toISOString()]});\n t=await licenseDb.execute({sql:\"SELECT * FROM tc_trials WHERE device_id=?\",args:[device]});\n }\n const trial=t.rows[0] as any, active=new Date(trial.expires_at)>new Date();\n return {active,status:active?\"trial\":\"expired\",expires_at:trial.expires_at,days_left:Math.max(0,Math.ceil((new Date(trial.expires_at).getTime()-Date.now())/86400000))};\n};\n\napp.get(\"/\",c=>c.html(Root()));\napp.get(\"/__immutable/*\",c=>serveImmutableFile(c.req.path));\napp.get(\"/source\",c=>c.redirect(parseVal().links.self.val));\napp.get(\"/api/license/status\",async c=>c.json(await state(c.req.query(\"device\")||\"\")));\napp.post(\"/api/license/activate\",async c=>{\n const {key,device}=await c.req.json();\n if(!key||!device) return c.json({ok:false,error:\"Datos incompletos\"},400);\n const q=await licenseDb.execute({sql:\"SELECT * FROM tc_licenses WHERE license_key=? AND active=1\",args:[String(key).trim().toUpperCase()]});\n if(!q.rows.length) return c.json({ok:false,error:\"Licencia inválida\"},404);\n const lic=q.rows[0] as any;\n if(lic.device_id&&lic.device_id!==device) return c.json({ok:false,error:\"Esta licencia ya está vinculada a otro equipo\"},409);\n const activated=lic.activated_at||new Date().toISOString();\n const expires=lic.expires_at||new Date(new Date(activated).getTime()+daysFor(lic.plan)*86400000).toISOString();\n if(new Date(expires)<=new Date()) return c.json({ok:false,error:\"Licencia vencida\"},410);\n await licenseDb.execute({sql:\"UPDATE tc_licenses SET device_id=?,activated_at=?,expires_at=? WHERE license_key=?\",args:[device,activated,expires,lic.license_key]});\n return c.json({ok:true,license:await state(device)});\n});\nconst collections=new Set([\"products\",\"sales\",\"clients\",\"suppliers\",\"finance\",\"business\"]);\napp.post(\"/api/store/register\",async c=>{\n const body=await c.req.json(),device=String(body.device||\"\");\n if(!device)return c.json({error:\"Equipo requerido\"},400);\n const access=await state(device);if(!access.active)return c.json({error:\"Licencia o prueba vencida\"},403);\n const exists=await appDb.execute({sql:\"SELECT device_id FROM tc_app_access WHERE device_id=?\",args:[device]});\n if(exists.rows.length)return c.json({error:\"La base ya está protegida en este equipo\"},409);\n const token=crypto.randomUUID().replaceAll(\"-\",\"\")+crypto.randomUUID().replaceAll(\"-\",\"\");\n const now=new Date().toISOString();\n await appDb.execute({sql:\"INSERT INTO tc_app_access(device_id,secret_hash,created_at,last_access_at) VALUES(?,?,?,?)\",args:[device,await secretHash(token),now,now]});\n await appDb.batch(Array.from(collections).map(collection=>({sql:\"INSERT INTO tc_app_store(device_id,collection,payload,updated_at) VALUES(?,?,?,?) ON CONFLICT(device_id,collection) DO NOTHING\",args:[device,collection,collection===\"business\"?JSON.stringify({name:\"Mi Tienda\",phone:\"\",rfc:\"\",printer:\"55\",logo:\"\"}):\"[]\",now]})));\n return c.json({ok:true,token});\n});\napp.get(\"/api/store/:collection\",async c=>{\n const collection=c.req.param(\"collection\"),device=c.req.query(\"device\")||\"\";\n if(!collections.has(collection))return c.json({error:\"Colección inválida\"},400);\n if(!await authorized(c,device))return c.json({error:\"Acceso no autorizado\"},401);\n const q=await appDb.execute({sql:\"SELECT payload,updated_at FROM tc_app_store WHERE device_id=? AND collection=?\",args:[device,collection]});\n if(!q.rows.length)return c.json({exists:false,data:null});\n const row=q.rows[0] as any;\n try{return c.json({exists:true,data:JSON.parse(row.payload),updated_at:row.updated_at})}catch{return c.json({exists:false,data:null})}\n});\napp.put(\"/api/store/:collection\",async c=>{\n const collection=c.req.param(\"collection\"),body=await c.req.json(),device=String(body.device||\"\");\n if(!collections.has(collection))return c.json({error:\"Colección inválida\"},400);\n if(!await authorized(c,device))return c.json({error:\"Acceso no autorizado\"},401);\n const payload=JSON.stringify(body.data??(collection===\"business\"?{}:[]));\n if(payload.length>6000000)return c.json({error:\"Datos demasiado grandes\"},413);\n const updated=new Date().toISOString();\n await appDb.execute({sql:\"INSERT INTO tc_app_store(device_id,collection,payload,updated_at) VALUES(?,?,?,?) ON CONFLICT(device_id,collection) DO UPDATE SET payload=excluded.payload,updated_at=excluded.updated_at\",args:[device,collection,payload,updated]});\n return c.json({ok:true,updated_at:updated});\n});\napp.get(\"/api/database/status\",async c=>{\n const device=c.req.query(\"device\")||\"\";\n if(!await authorized(c,device))return c.json({connected:false,error:\"Acceso no autorizado\"},401);\n const q=await appDb.execute({sql:\"SELECT collection,updated_at FROM tc_app_store WHERE device_id=? ORDER BY collection\",args:[device]});\n return c.json({connected:true,collections:q.rows});\n});\n\napp.get(\"/api/plans\",c=>c.json([\n {id:\"semanal\",name:\"Semanal\",days:7},{id:\"mensual\",name:\"Mensual\",days:30},\n {id:\"semestral\",name:\"Semestral\",days:182},{id:\"anual\",name:\"Anual\",days:365}\n]));\napp.onError(err=>Promise.reject(err));\nexport default app.fetch;","children",[],[342],"f8db0b98-4645-4bd7-85dd-1f49fbc9f50f","README.md","01a027f5-8329-75bb-a811-acc7021ccbd6",["D",1787376796366],"# 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",[],[352],"852662b2-b866-41d6-a841-b920dc8a770f","CHANGELOG.md","01a027f5-8329-75bb-a811-a9ae9f5b5e5b",["D",1787376796366],"# 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

History · Counter.tsx