`, 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",{"_495":496,"_497":498},"routes/_app.x.$handle.$name",{"_99":98,"_31":44,"_108":89,"_26":103,"_13":14,"_109":-5,"_11":110,"_111":112,"_113":114,"_115":116,"_117":118,"_20":-5,"_119":-5,"_120":-5,"_121":24,"_122":123,"_124":58,"_125":-5,"_126":-5,"_127":128},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_42":43,"_31":44,"_37":45,"_46":-5,"_47":24,"_48":49,"_50":49,"_51":52,"_53":-5,"_18":54,"_55":56,"_57":58,"_59":-5,"_60":-5,"_61":62,"_63":64,"_65":66,"_67":68,"_69":70,"_71":-5,"_72":73,"_74":73,"_75":76,"_77":76,"_78":76,"_79":73,"_80":73,"_81":82,"_83":84,"_85":86,"_87":24},"version",38,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":-7,"_23":24,"_25":24,"_26":27,"_28":27},"file",{"_29":30,"_31":32,"_33":34,"_35":36,"_37":38,"_39":14,"_40":41,"_23":24},"previous","deleted",false,"deletedHere","path","frontend/api.ts","latestPath","fileId","3d190b0c-b008-11f1-9891-1607ee4eb77e","name","api.ts","fileType","script","content","import type { EventsResponse, ScrapedEvent } from \"../shared/types.ts\";\nimport { load, remove, save } from \"./storage.ts\";\n\nconst CACHE_KEY = \"cwz_events\";\nconst PIN_KEY = \"cwz_pin\";\n\nexport class PinError extends Error {}\n\nexport async function fetchEvents(): Promise {\n const res = await fetch(`/api/events?days=21&to=${farDate()}`);\n if (!res.ok) throw new Error(`Błąd serwera (${res.status})`);\n const data = await res.json() as EventsResponse;\n save(CACHE_KEY, data);\n return data;\n}\n\n// Three weeks ahead covers every tab\nfunction farDate() {\n const d = new Date();\n d.setDate(d.getDate() + 21);\n return d.toISOString().slice(0, 10);\n}\n\nexport const cachedEvents = () => load(CACHE_KEY, null);\n\nexport const savedPin = () => load(PIN_KEY, null);\n\nasync function admin(path: string, body: unknown, pin = savedPin()): Promise {\n const res = await fetch(`/api/admin/${path}`, {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\", \"x-pin\": pin ?? \"\" },\n body: JSON.stringify(body ?? {}),\n });\n const data = await res.json().catch(() => ({}));\n if (res.status === 401 && data.pin) {\n remove(PIN_KEY);\n throw new PinError(data.error ?? \"Nieprawidłowy PIN.\");\n }\n if (!res.ok) throw new Error(data.error ?? `Błąd serwera (${res.status})`);\n return data as T;\n}\n\nexport const api = {\n async checkPin(pin: string) {\n await admin(\"pin\", {}, pin);\n save(PIN_KEY, pin);\n },\n extract: (input: { text?: string; url?: string }) => admin<{ events: ScrapedEvent[] }>(\"extract\", input),\n addEvent: (event: Partial) => admin<{ ok: true }>(\"events\", event),\n hideEvent: (id: number) => admin<{ ok: true }>(`events/${id}/hide`, {}),\n async subscribe(subscription: PushSubscriptionJSON, favorites: number[]) {\n await fetch(\"/api/push\", {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\" },\n body: JSON.stringify({ subscription, favorites }),\n });\n },\n};\n","createdAt",["D",1789368485638],"branchVersion","branchId","255405a6-055f-4761-b8d5-94d1ffe681e3","id","25f66c95-84fd-4431-a007-b1f4e010323a","co-w-zamosciu",["D",1789336184443],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","Co dziś w Zamościu i na Roztoczu — koncerty, kino, wydarzenia","imageUrl","5dd5cdfa-b36a-42e1-a911-81ba86e3b64c","pinnedFileId","01a09cbf-66da-7600-85d1-7a5d4b41e0de","pinPreview",true,"pinMigrated","screenshotVersion","likeCount",0,"orgId","01a09aab-d118-725d-b44f-c12d328bfdc6","tursoName","25f66c9584fd4431a007b1f4e010323a","tursoHostname","25f66c9584fd4431a007b1f4e010323a-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789519256886],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_99":98,"_107":103},"org",{"_99":98,"_100":101,"_102":103,"_18":54,"_104":105,"_106":24},"branch",{"_13":88,"_31":89,"_42":41,"_90":43,"_91":-5,"_92":-5,"_93":-5,"_94":-5,"_95":-5,"_96":44,"_97":98},"isOwned",150,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","dominik1","handle","displayName","Dominik","avatar","","tier","free","canRestrictVals","profileImageUrl","branchName","adoptOrgId",{"_42":43,"_31":44,"_37":490,"_46":-5,"_47":24,"_48":49,"_50":49,"_51":52,"_53":-5,"_18":54,"_55":56,"_57":58,"_59":-5,"_60":-5,"_61":62,"_63":64,"_65":66,"_67":68,"_69":491,"_71":-5,"_72":73,"_74":73,"_75":76,"_77":76,"_78":76,"_79":73,"_80":73,"_81":492,"_83":493,"_85":494,"_87":24},"tree",[201,218,221,232,234,236,237,238],"files",[201,202,203,204,205,206,207,208,209,210,211,212,213,214,215,216,217,218,219,220,221,222,223,224,225,226,227,228,229,230,231,232,233,234,235,236,237,238],"counts",{"_190":62,"_191":143,"_192":62,"_193":194,"_195":196},"contents",[129,130,131,132,133,134,135,136],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_42":184,"_31":185,"_29":186,"_139":-5,"_40":41,"_39":187,"_141":58,"_37":188,"_13":62,"_33":165,"_35":-5,"_23":24,"_146":-5,"_26":189},{"_42":178,"_31":179,"_29":180,"_139":-5,"_40":41,"_39":181,"_141":58,"_37":182,"_13":62,"_33":165,"_35":-5,"_23":24,"_146":-5,"_26":183},{"_42":173,"_31":174,"_29":175,"_139":-5,"_40":41,"_39":143,"_141":58,"_37":176,"_13":62,"_33":165,"_35":-5,"_23":24,"_146":-5,"_26":177},{"_42":167,"_31":168,"_29":169,"_139":-5,"_40":41,"_39":170,"_141":58,"_37":171,"_13":62,"_33":165,"_35":-5,"_23":24,"_146":-5,"_26":172},{"_42":160,"_31":161,"_29":162,"_139":-5,"_40":41,"_39":163,"_141":58,"_37":164,"_13":62,"_33":165,"_35":-5,"_23":24,"_146":-5,"_26":166},{"_42":154,"_31":155,"_29":156,"_139":-5,"_40":41,"_39":143,"_141":58,"_37":157,"_13":62,"_33":20,"_35":158,"_23":24,"_146":-5,"_26":159},{"_42":148,"_31":149,"_29":150,"_139":-5,"_40":41,"_39":143,"_141":24,"_37":151,"_13":62,"_33":20,"_35":152,"_23":24,"_146":-5,"_26":153},{"_42":137,"_31":138,"_29":56,"_139":-5,"_40":41,"_39":140,"_141":24,"_37":142,"_13":143,"_33":144,"_35":145,"_23":24,"_146":44,"_26":147},"1d30cf87-ed54-472c-ada2-b9947d24607b","index.ts","parentId",28,"latest",["D",1789368375905],1,"http","import { immutableFileUrl, parseVal, readFile, serveFile, serveImmutableFile } from \"https://esm.town/v/std/utils/index.ts\";\nimport { Hono } from \"npm:hono\";\nimport { requirePin } from \"./backend/auth.ts\";\nimport {\n getEvent,\n getMeta,\n hideEvent,\n initDb,\n listEvents,\n listSources,\n saveSubscription,\n upsertEvents,\n} from \"./backend/db.ts\";\nimport { fetchText, pageText } from \"./backend/fetch.ts\";\nimport { toIcs } from \"./backend/ics.ts\";\nimport { ICONS } from \"./backend/icons.ts\";\nimport { extractEvents } from \"./backend/llm.ts\";\nimport { addDays, clean, isDate, isTime, warsawToday } from \"./backend/normalize.ts\";\nimport { Root } from \"./frontend/root.tsx\";\nimport { type EventsResponse, isCategory, type ScrapedEvent } from \"./shared/types.ts\";\n\nawait initDb();\n\nconst app = new Hono();\n\n// Serve the (never-cached) HTML shell at the root /\napp.get(\"/\", (c) => c.html(Root()));\n\n// Serve frontend files at the version-addressed URLs Root() stamps, cached immutably\napp.get(\"/__immutable/*\", (c) => serveImmutableFile(c.req.path));\n\napp.get(\"/favicon.svg\", () => serveFile(\"/frontend/favicon.svg\", import.meta.url));\n\napp.get(\"/source\", (c) => c.redirect(parseVal().links.self.val));\n\napp.get(\"/icons/:name\", (c) => {\n const base64 = ICONS[c.req.param(\"name\")];\n if (!base64) return c.notFound();\n const bytes = Uint8Array.from(atob(base64), (ch) => ch.charCodeAt(0));\n return c.body(bytes, 200, { \"Content-Type\": \"image/png\", \"Cache-Control\": \"public, max-age=604800\" });\n});\n\n// Lets the app be installed on the phone's home screen\napp.get(\"/manifest.webmanifest\", (c) =>\n c.json({\n name: \"Co w Zamościu\",\n short_name: \"Co w Zamościu\",\n description: \"Koncerty, kino i wydarzenia w Zamościu i na Roztoczu\",\n lang: \"pl\",\n start_url: \"/\",\n display: \"standalone\",\n theme_color: \"#17203a\",\n background_color: \"#17203a\",\n icons: [\n { src: \"/icons/icon-192.png\", sizes: \"192x192\", type: \"image/png\" },\n { src: \"/icons/icon-512.png\", sizes: \"512x512\", type: \"image/png\" },\n { src: \"/icons/icon-maskable-512.png\", sizes: \"512x512\", type: \"image/png\", purpose: \"maskable\" },\n ],\n }, 200, { \"Content-Type\": \"application/manifest+json\" }));\n\n// The service worker has to be served from the root to control the whole app.\n// The version stamp changes its bytes on every deploy, so phones pick up updates.\napp.get(\"/sw.js\", async (c) => {\n const source = await readFile(\"/frontend/sw.js\", import.meta.url);\n const version = immutableFileUrl(\"/frontend/sw.js\").split(\"/\")[2];\n return c.body(`const VERSION = ${JSON.stringify(version)};\\n${source}`, 200, {\n \"Content-Type\": \"text/javascript; charset=utf-8\",\n \"Cache-Control\": \"no-cache\",\n });\n});\n\n// ---------- public API ----------\n\napp.get(\"/api/events\", async (c) => {\n const today = warsawToday();\n const from = isDate(c.req.query(\"from\")) ? c.req.query(\"from\")! : today;\n let to = isDate(c.req.query(\"to\")) ? c.req.query(\"to\")! : addDays(from, 14);\n if (to < from) to = from;\n if (to > addDays(from, 62)) to = addDays(from, 62);\n const body: EventsResponse = {\n events: await listEvents(from, to),\n today,\n updatedAt: Number(await getMeta(\"last_scrape\")) || null,\n vapidPublicKey: Deno.env.get(\"VAPID_PUBLIC_KEY\") ?? null,\n };\n return c.json(body, 200, { \"Cache-Control\": \"no-store\" });\n});\n\napp.get(\"/ics/:id\", async (c) => {\n const event = await getEvent(Number(c.req.param(\"id\")));\n if (!event) return c.notFound();\n return c.body(toIcs(event), 200, {\n \"Content-Type\": \"text/calendar; charset=utf-8\",\n \"Content-Disposition\": `attachment; filename=\"wydarzenie-${event.id}.ics\"`,\n });\n});\n\napp.get(\"/api/status\", async (c) =>\n c.json({ sources: await listSources(), updatedAt: Number(await getMeta(\"last_scrape\")) || null }));\n\n// Only real push services, so the server never posts to arbitrary URLs\nconst PUSH_HOST =\n /^(fcm\\.googleapis\\.com|android\\.googleapis\\.com|updates\\.push\\.services\\.mozilla\\.com|[\\w.-]+\\.push\\.apple\\.com|[\\w.-]+\\.notify\\.windows\\.com)$/;\n\napp.post(\"/api/push\", async (c) => {\n const body = await c.req.json().catch(() => null);\n const endpoint = body?.subscription?.endpoint;\n const p256dh = body?.subscription?.keys?.p256dh;\n const auth = body?.subscription?.keys?.auth;\n let validHost = false;\n try {\n const url = new URL(endpoint);\n validHost = url.protocol === \"https:\" && PUSH_HOST.test(url.hostname);\n } catch {\n // not a URL\n }\n if (!validHost || typeof p256dh !== \"string\" || typeof auth !== \"string\") {\n return c.json({ error: \"Nieprawidłowa subskrypcja powiadomień.\" }, 400);\n }\n const favorites = Array.isArray(body?.favorites)\n ? body.favorites.filter((id: unknown) => Number.isInteger(id)).slice(0, 200)\n : [];\n await saveSubscription(endpoint, p256dh, auth, favorites);\n return c.json({ ok: true });\n});\n\n// ---------- PIN-protected API ----------\n\napp.use(\"/api/admin/*\", requirePin);\n\napp.post(\"/api/admin/pin\", (c) => c.json({ ok: true }));\n\n// Poster text, a Facebook post or a link → pre-filled event form\napp.post(\"/api/admin/extract\", async (c) => {\n const body = await c.req.json().catch(() => null);\n const text = typeof body?.text === \"string\" ? body.text.slice(0, 8000) : \"\";\n const url = typeof body?.url === \"string\" && /^https?:\\/\\//.test(body.url) ? body.url : null;\n let input = text;\n if (url) {\n try {\n input = `${text}\\n\\nStrona ${url}:\\n${pageText(await fetchText(url), url, 10_000)}`;\n } catch (err) {\n if (!text) return c.json({ error: `Nie udało się pobrać strony (${(err as Error).message}).` }, 422);\n }\n }\n if (!input.trim()) return c.json({ error: \"Wklej tekst albo link.\" }, 400);\n const events = await extractEvents(input, {\n context: \"Tekst wkleił użytkownik: plakat, post z Facebooka albo strona wydarzenia.\" +\n (url ? ` Link do wydarzenia: ${url}` : \"\"),\n });\n return c.json({ events: events.map((e) => ({ ...e, url: e.url ?? url })) });\n});\n\nfunction parseEvent(body: Record | null): ScrapedEvent | null {\n if (!body || typeof body.title !== \"string\" || !body.title.trim() || !isDate(body.date)) return null;\n const text = (v: unknown, max: number) => (typeof v === \"string\" ? clean(v, max) : null);\n return {\n title: clean(body.title, 140)!,\n date: body.date,\n endDate: isDate(body.endDate) && body.endDate > body.date ? body.endDate : null,\n time: isTime(body.time) ? body.time : null,\n place: text(body.place, 120),\n town: text(body.town, 60) ?? \"Zamość\",\n category: isCategory(body.category) ? body.category : \"inne\",\n price: text(body.price, 60),\n imageUrl: null,\n url: typeof body.url === \"string\" && /^https?:\\/\\//.test(body.url) ? body.url : null,\n description: text(body.description, 600),\n showtimes: null,\n };\n}\n\napp.post(\"/api/admin/events\", async (c) => {\n const event = parseEvent(await c.req.json().catch(() => null));\n if (!event) return c.json({ error: \"Podaj co najmniej tytuł i datę.\" }, 400);\n await upsertEvents(\"manual\", 5, [event], true);\n return c.json({ ok: true });\n});\n\napp.post(\"/api/admin/events/:id/hide\", async (c) => {\n await hideEvent(Number(c.req.param(\"id\")));\n return c.json({ ok: true });\n});\n\n// Unwrap and rethrow Hono errors as the original error\n// If you delete this, all errors will be \"Internal Server Error\"\napp.onError((err) => Promise.reject(err));\n\n// HTTP vals expect an exported \"fetch handler\"\n// This is how you \"run the server\" in Val Town with Hono\nexport default app.fetch;\n","label",[138],"6f9cf8c5-cc6d-47ba-b106-6d7e24b7f39b","README.md","01a09cbf-66da-7600-85d1-77f7ef9c20ff",["D",1789336184443],"# 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],"42cea312-1aaf-4642-b2da-e3bba05e69b9","CHANGELOG.md","01a09cbf-66da-7600-85d1-72302458f448",["D",1789336184443],"# 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 · v38