`, 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",{"_573":574,"_575":576},"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",72,"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/adapters/zak.ts","latestPath","fileId","66a64356-b00b-11f1-b4c7-1607ee4eb77e","name","zak.ts","fileType","script","content","import { load } from \"npm:cheerio@1.0.0\";\nimport type { ScrapedEvent, Showtime } from \"../../shared/types.ts\";\nimport { absolute, fetchDom, fetchText } from \"../fetch.ts\";\nimport { addDays, clean, guessCategory, warsawToday } from \"../normalize.ts\";\nimport { titleCase } from \"./stylowy.ts\";\n\nconst API = \"https://zakzamosc.pl/wp-json/tribe/events/v1/events\";\nconst CINEMA = \"https://www.stylowy.net/oferta/35-sala-kinowa-zamojskiej-akademii-kultury.html\";\nconst STYLOWY = \"https://www.stylowy.net/\";\nconst DAYS = 21;\nconst PLACE = \"Zamojska Akademia Kultury\";\nconst CINEMA_PLACE = \"Kino ZAK\";\n\ninterface TribeEvent {\n title: string;\n start_date: string; // \"2026-09-15 11:00:00\", local time\n end_date: string;\n all_day: boolean;\n url: string;\n excerpt: string;\n description: string;\n cost: string;\n image: false | { url?: string };\n venue?: { venue?: string } | [];\n}\n\n// HTML entities and \"𝗯𝗼𝗹𝗱\" unicode letters → plain text\nconst plain = (html: string) => load(`

${html}

`).text().normalize(\"NFKC\");\n\n// The ZAK cinema hall, listed on the Stylowy site: one card per screening\nasync function cinema(today: string): Promise {\n const $ = await fetchDom(CINEMA);\n const films = new Map();\n $(\".card\").each((_, el) => {\n const card = $(el);\n const day = card.find(\".card-header\").text().match(/(\\d{2})-(\\d{2})-(\\d{4})/);\n const link = card.find(\".card-body a[title]\").first();\n const label = card.find(\".card-body strong\").text();\n const time = label.match(/godz\\.\\s*(\\d{1,2}):(\\d{2})/);\n if (!day || !link.length || !time) return;\n const date = `${day[3]}-${day[2]}-${day[1]}`;\n if (date < today) return;\n const title = titleCase(clean(link.attr(\"title\"), 140) ?? \"\");\n const show: Showtime = {\n time: `${time[1].padStart(2, \"0\")}:${time[2]}`,\n url: card.find(\".card-footer a\").attr(\"href\") ?? null,\n };\n const key = `${date}|${title}`;\n const film = films.get(key);\n if (film) {\n film.showtimes = [...(film.showtimes ?? []), show].sort((a, b) => a.time.localeCompare(b.time));\n film.time = film.showtimes[0].time;\n return;\n }\n const version = label.match(/\\/\\s*([^-]+?)\\s+-\\s+godz/)?.[1]?.trim().toLowerCase();\n films.set(key, {\n title,\n date,\n endDate: null,\n time: show.time,\n place: CINEMA_PLACE,\n town: \"Zamość\",\n category: \"kino\",\n price: null,\n imageUrl: absolute(card.find(\"img\").attr(\"src\"), STYLOWY),\n url: absolute(link.attr(\"href\"), STYLOWY),\n description: [\"sala kinowa Zamojskiej Akademii Kultury\", version].filter(Boolean).join(\" · \"),\n showtimes: [show],\n });\n });\n return [...films.values()];\n}\n\n// Everything else from the ZAK calendar (The Events Calendar REST API)\nasync function calendar(today: string, screenings: ScrapedEvent[]): Promise {\n const until = `${addDays(today, DAYS)} 23:59:59`;\n let next: string | null = `${API}?per_page=50&start_date=${today}&end_date=${encodeURIComponent(until)}`;\n const raw: TribeEvent[] = [];\n for (let page = 0; next && page < 5; page++) {\n const data = JSON.parse(await fetchText(next));\n raw.push(...(data.events ?? []));\n next = data.next_rest_url ?? null;\n }\n\n // Weekly classes (mind training, board games, dance groups) would bury the one-off events\n const repeats = new Map();\n for (const e of raw) {\n const title = clean(plain(e.title), 140) ?? \"\";\n repeats.set(title, (repeats.get(title) ?? 0) + 1);\n }\n const screeningSlots = new Set(screenings.flatMap((s) => (s.showtimes ?? []).map((sh) => `${s.date} ${sh.time}`)));\n\n const events: ScrapedEvent[] = [];\n for (const e of raw) {\n const title = clean(plain(e.title), 140);\n if (!title || (repeats.get(title) ?? 0) >= 3 || /grupa\\s+[ivx\\d]/i.test(title)) continue;\n const date = e.start_date.slice(0, 10);\n const endDate = e.end_date.slice(0, 10);\n const time = e.all_day ? null : e.start_date.slice(11, 16);\n if (endDate < today) continue;\n // senior cinema and similar screenings are already in the cinema listing\n if (time && screeningSlots.has(`${date} ${time}`)) continue;\n const description = clean(plain(e.excerpt || e.description), 300);\n const venue = Array.isArray(e.venue) ? undefined : e.venue?.venue;\n events.push({\n title,\n date,\n endDate: endDate > date ? endDate : null,\n time,\n place: clean(venue, 120) ?? PLACE,\n town: \"Zamość\",\n category: guessCategory(`${title} ${description ?? \"\"}`),\n price: clean(e.cost, 60),\n imageUrl: e.image && e.image.url ? e.image.url : null,\n url: e.url,\n description,\n showtimes: null,\n });\n }\n return events;\n}\n\nexport async function zak(): Promise {\n const today = warsawToday();\n const films = await cinema(today).catch((err) => {\n console.warn(\"ZAK cinema failed\", err);\n return [];\n });\n return [...films, ...await calendar(today, films)];\n}\n","createdAt",["D",1789369843827],"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":568,"_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":569,"_71":-5,"_72":73,"_74":73,"_75":76,"_77":76,"_78":76,"_79":73,"_80":73,"_81":570,"_83":571,"_85":572,"_87":24},"tree",[202,220,223,241,243,245,246,247],"files",[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,239,240,241,242,243,244,245,246,247],"counts",{"_191":62,"_192":143,"_193":62,"_194":195,"_196":197},"contents",[129,130,131,132,133,134,135,136],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_42":185,"_31":186,"_29":187,"_139":-5,"_40":41,"_39":188,"_141":58,"_37":189,"_13":62,"_33":166,"_35":-5,"_23":24,"_146":-5,"_26":190},{"_42":179,"_31":180,"_29":181,"_139":-5,"_40":41,"_39":182,"_141":58,"_37":183,"_13":62,"_33":166,"_35":-5,"_23":24,"_146":-5,"_26":184},{"_42":174,"_31":175,"_29":176,"_139":-5,"_40":41,"_39":143,"_141":58,"_37":177,"_13":62,"_33":166,"_35":-5,"_23":24,"_146":-5,"_26":178},{"_42":168,"_31":169,"_29":170,"_139":-5,"_40":41,"_39":171,"_141":58,"_37":172,"_13":62,"_33":166,"_35":-5,"_23":24,"_146":-5,"_26":173},{"_42":161,"_31":162,"_29":163,"_139":-5,"_40":41,"_39":164,"_141":58,"_37":165,"_13":62,"_33":166,"_35":-5,"_23":24,"_146":-5,"_26":167},{"_42":155,"_31":156,"_29":157,"_139":-5,"_40":41,"_39":143,"_141":58,"_37":158,"_13":62,"_33":20,"_35":159,"_23":24,"_146":-5,"_26":160},{"_42":148,"_31":149,"_29":150,"_139":-5,"_40":41,"_39":151,"_141":24,"_37":152,"_13":143,"_33":20,"_35":153,"_23":24,"_146":-5,"_26":154},{"_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],"e478e360-b92c-47a5-9eed-6e470418ce3a","README.md","01a09cbf-66da-7600-85d1-77f7ef9c20ff",52,["D",1789368940845],"# 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): dane schema.org,\n - tuzamosc.pl,\n - Zamojski Dom Kultury: godziny ze stron szczegółów,\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- 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",["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 · v72