`, 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",{"_621":622,"_623":624},"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",126,"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","backend/apify.ts","latestPath","fileId","46193a12-b029-11f1-bdef-1607ee4eb77e","name","apify.ts","fileType","script","content","import { addDays, warsawToday } from \"./normalize.ts\";\n\nconst API = \"https://api.apify.com/v2\";\nconst ACTOR = \"apify~facebook-events-scraper\";\n\n// The searches configured in the Apify console, now limited to upcoming dates\nexport const FACEBOOK_QUERIES = [\"Zamość\", \"Chełm\", \"Tomaszów Lubelski\", \"Biłgoraj\", \"Krasnystaw\", \"Roztocze\"];\nconst DAYS_AHEAD = 30;\nconst MAX_EVENTS = 30;\n// Apify charges per event in the result; a run stops once it would cost more than this\nconst MAX_CHARGE_USD = 1;\n\n// Facebook's event search keeps its filters in a base64 JSON parameter; two key spellings are in use\nexport type DateFilterVariant = \"rp_events_date\" | \"filter_events_date_range\";\n\nfunction token() {\n const value = Deno.env.get(\"APIFY_TOKEN\")?.trim();\n if (!value) throw new Error(\"Brak APIFY_TOKEN — dodaj klucz Apify w zmiennych środowiskowych vala\");\n return value;\n}\n\nasync function api(path: string, init?: RequestInit): Promise {\n const url = `${API}${path}${path.includes(\"?\") ? \"&\" : \"?\"}token=${token()}`;\n const res = await fetch(url, { ...init, signal: AbortSignal.timeout(30_000) });\n if (!res.ok) throw new Error(`Apify ${res.status}: ${(await res.text()).slice(0, 200)}`);\n return await res.json() as T;\n}\n\n/** Facebook event search for a phrase, limited to events between two dates (YYYY-MM-DD). */\nexport function facebookSearchUrl(query: string, from: string, to: string, variant: DateFilterVariant = \"rp_events_date\") {\n const filter = variant === \"rp_events_date\"\n ? { \"rp_events_date:0\": JSON.stringify({ name: \"filter_events_date\", args: `${from}~${to}` }) }\n : { \"filter_events_date_range:0\": JSON.stringify({ name: \"filter_events_date_range\", args: `${from}~${to}` }) };\n const encoded = btoa(JSON.stringify(filter));\n return `https://www.facebook.com/events/search/?q=${encodeURIComponent(query)}&filters=${encodeURIComponent(encoded)}`;\n}\n\ninterface Run {\n id: string;\n status: string;\n defaultDatasetId: string;\n startedAt: string;\n finishedAt: string | null;\n usageTotalUsd?: number;\n}\n\nexport async function getRun(runId: string): Promise {\n return (await api<{ data: Run }>(`/actor-runs/${runId}`)).data;\n}\n\n/** Starts the scraper and returns at once (a run takes a few minutes; the next scrape reads its result). */\nexport async function startFacebookRun(opts: {\n queries?: string[];\n maxEvents?: number;\n maxChargeUsd?: number;\n variant?: DateFilterVariant;\n} = {}) {\n const last = await api<{ data: Run }>(`/acts/${ACTOR}/runs/last`).catch(() => null);\n if (last && [\"READY\", \"RUNNING\"].includes(last.data.status)) {\n return { skipped: true, runId: last.data.id };\n }\n const today = warsawToday();\n const until = addDays(today, DAYS_AHEAD);\n const input = {\n startUrls: (opts.queries ?? FACEBOOK_QUERIES).map((q) => ({ url: facebookSearchUrl(q, today, until, opts.variant) })),\n maxEvents: opts.maxEvents ?? MAX_EVENTS,\n };\n const run = await api<{ data: Run }>(`/acts/${ACTOR}/runs?maxTotalChargeUsd=${opts.maxChargeUsd ?? MAX_CHARGE_USD}`, {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\" },\n body: JSON.stringify(input),\n });\n return { skipped: false, runId: run.data.id, datasetId: run.data.defaultDatasetId };\n}\n\n/** Items of the latest successful run (whether started by the app or by hand in the Apify console). */\nexport async function lastFacebookItems(): Promise {\n return await api(`/acts/${ACTOR}/runs/last/dataset/items?status=SUCCEEDED&clean=true`);\n}\n\nexport async function datasetItems(datasetId: string): Promise {\n return await api(`/datasets/${datasetId}/items?clean=true`);\n}\n","createdAt",["D",1789382674129],"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":616,"_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":617,"_71":-5,"_72":73,"_74":73,"_75":76,"_77":76,"_78":76,"_79":73,"_80":73,"_81":618,"_83":619,"_85":620,"_87":24},"tree",[203,226,229,247,249,251,252,253],"files",[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,239,240,241,242,243,244,245,246,247,248,249,250,251,252,253],"counts",{"_192":62,"_193":159,"_194":62,"_195":196,"_197":198},"contents",[129,130,131,132,133,134,135,136],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_42":187,"_31":188,"_29":189,"_139":-5,"_40":41,"_39":143,"_141":58,"_37":190,"_13":62,"_33":168,"_35":-5,"_23":24,"_146":-5,"_26":191},{"_42":181,"_31":182,"_29":183,"_139":-5,"_40":41,"_39":184,"_141":58,"_37":185,"_13":62,"_33":168,"_35":-5,"_23":24,"_146":-5,"_26":186},{"_42":176,"_31":177,"_29":178,"_139":-5,"_40":41,"_39":159,"_141":58,"_37":179,"_13":62,"_33":168,"_35":-5,"_23":24,"_146":-5,"_26":180},{"_42":170,"_31":171,"_29":172,"_139":-5,"_40":41,"_39":173,"_141":58,"_37":174,"_13":62,"_33":168,"_35":-5,"_23":24,"_146":-5,"_26":175},{"_42":163,"_31":164,"_29":165,"_139":-5,"_40":41,"_39":166,"_141":58,"_37":167,"_13":62,"_33":168,"_35":-5,"_23":24,"_146":-5,"_26":169},{"_42":156,"_31":157,"_29":158,"_139":-5,"_40":41,"_39":159,"_141":58,"_37":160,"_13":62,"_33":20,"_35":161,"_23":24,"_146":-5,"_26":162},{"_42":148,"_31":149,"_29":150,"_139":-5,"_40":41,"_39":151,"_141":24,"_37":152,"_13":153,"_33":20,"_35":154,"_23":24,"_146":-5,"_26":155},{"_42":137,"_31":138,"_29":56,"_139":-5,"_40":41,"_39":140,"_141":58,"_37":142,"_13":143,"_33":144,"_35":145,"_23":24,"_146":44,"_26":147},"8060d248-5062-4b29-84b0-7417e053dfdb","index.ts","parentId",103,"latest",["D",1789370237687],3,"http","import { immutableFileUrl, 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(\"/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],"4406cbd5-98d7-499e-ae60-e101e732ff6e","README.md","01a09cbf-66da-7600-85d1-77f7ef9c20ff",123,["D",1789372533742],4,"# Co w Zamościu\n\nMobilna aplikacja (PWA do zainstalowania na telefonie): co dziś, jutro i w weekend dzieje się w Zamościu i na Roztoczu. Koncerty, kino, teatr, festyny, sport, wydarzenia dla dzieci.\n\n👉 https://co-w-zamosciu.val.run\n\n## Jak to działa\n\n- **`cron/scrape.ts`** zbiera wydarzenia 3 razy dziennie (6:00, 12:00, 18:00 czasu letniego) z:\n - Biletyna (Zamość, Biłgoraj, Tomaszów Lub., Hrubieszów, Krasnystaw, Chełm): dane schema.org, seanse kin łączone w jedną kartę filmu,\n - tuzamosc.pl,\n - Zamojski Dom Kultury: godziny ze stron szczegółów,\n - Zamojska Akademia Kultury: kalendarz przez API (bez cotygodniowych zajęć) i sala kinowa ZAK,\n - Melodia Smaku (Jazz Club Kosz): kalendarz ze strony,\n - Kino Stylowy: repertuar na tydzień, w aplikacji jako jedna karta dziennie,\n - KS Hetman Zamość: mecze u siebie,\n - Kronika Tygodnia: festyny i pikniki w powiatach,\n - Super Tydzień Chełmski: Chełm i Krasnystaw,\n - Krasnostawski Dom Kultury,\n - Biłgorajskie Centrum Kultury: zapowiedzi czytane przez AI i kino (tylko okresy wyświetlania, bez godzin),\n - OSiR Biłgoraj: kalendarz imprez i meczów (bez rozgrywek młodzieżowych).\n- Tytuły filmów z repertuarów pisanych wersalikami dostają poprawną wielkość liter od AI (z cache).\n- Nie da się pobierać automatycznie: Arabeska (ogłasza tylko na Facebooku i Instagramie). Takie wydarzenia dodajesz przyciskiem ＋.\n- To samo wydarzenie z kilku stron jest scalane w jedno. Decyduje ten sam dzień, zgodna godzina i podobny tytuł.\n- Wydarzenia, których reguły nie przypisały do kategorii, klasyfikuje AI (`std/openai`, gpt-5.4-nano). Wystarcza darmowy limit Val Town.\n- **`cron/digest.ts`** codziennie o 8:00 wysyła push na telefony (Twoje „Idę” są na początku) i mail do właściciela. W piątek dochodzi zapowiedź weekendu i ostrzeżenia o źródłach, które przestały działać.\n- **Dodawanie ręczne** (przycisk ＋, wymaga PIN-u): wklej tekst z plakatu, posta z FB albo link, a AI wypełni formularz.\n- Stan źródeł: `/api/status`.\n\n## Zmienne środowiskowe\n\n- `ADD_PIN`: PIN do dodawania i ukrywania wydarzeń.\n- `VAPID_PUBLIC_KEY`, `VAPID_PRIVATE_KEY`: klucze Web Push. Po zmianie trzeba ponownie włączyć powiadomienia na telefonach.\n- `OPENAI_API_KEY` (opcjonalnie): własny klucz, jeśli darmowy limit Val Town okaże się za mały.\n\n👉 Add ADD_PIN here: https://www.val.town/x/dominik1/co-w-zamosciu/environment-variables?key=ADD_PIN\n\n## Struktura\n\n- `index.ts`: serwer Hono (strona, manifest, ikony, service worker, API, pliki .ics)\n- `backend/adapters/*`: parsery poszczególnych stron\n- `backend/sources.ts`: rejestr źródeł i przebieg zbierania\n- `backend/db.ts`: SQLite (wydarzenia, źródła, subskrypcje push, cache AI)\n- `backend/normalize.ts`: daty w strefie Europe/Warsaw, kategorie, miejscowości, deduplikacja\n- `backend/llm.ts`: AI do odczytu tekstu i klasyfikacji\n- `frontend/`: interfejs React, service worker, powiadomienia\n- `scripts/test-adapters.ts`: próbny przebieg parserów bez zapisu (do diagnozy, gdy strona zmieni układ)\n\nNowe źródło dodajesz jako adapter w `backend/adapters/` i wpis w `SOURCES` w `backend/sources.ts`.\n",[149],"42cea312-1aaf-4642-b2da-e3bba05e69b9","CHANGELOG.md","01a09cbf-66da-7600-85d1-72302458f448",1,["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 · v126