[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_296":297,"_298":299},"routes/_app.x.$handle.$name",{"_99":98,"_32":44,"_107":89,"_27":108,"_13":14,"_109":-5,"_11":110,"_111":112,"_113":114,"_115":116,"_117":118,"_20":-5,"_119":-5,"_120":-5,"_121":25,"_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,"_32":44,"_37":45,"_46":-5,"_47":25,"_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":25},"version",10,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":28,"_33":20,"_34":36,"_37":38,"_39":14,"_40":41,"_24":25},"previous",{"_30":31,"_32":28,"_33":20,"_34":35},"deleted",false,"deletedHere","path","README.md","latestPath","fileId","01a09756-1b07-73f6-b585-4b37ed1fb3da","name","fileType","content","# 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","# Tamashi · თამაში\n\nA Georgian-first home for small browser games. Working brand: **Tamashi**.\n\n**Live:** https://tamashi.val.run/ \n**English:** https://tamashi.val.run/en \n**Val Town project:** https://www.val.town/x/omriluz/tamashi/code/\n\n## What is implemented\n\n* Georgian and English pages, language-aware navigation and responsive layouts.\n* Custom inline SVG game artwork, reusable UI components and a shared design system.\n* A searchable, category-filtered game catalog, local favorites and recently opened games.\n* Dedicated game pages, click-to-load player, supported-browser fullscreen and sharing.\n* The original Supra Stack game is embedded without modifying or copying its source.\n* Five future-game **concepts**, clearly marked and not playable. These are replaceable placeholders, not release commitments.\n* About, privacy, real 404 pages, sitemap, robots, canonical/hreflang, Open Graph text and basic structured data.\n* No accounts, payments, advertisements, analytics scripts, email collection or global leaderboard in this skeleton.\n\n## Architecture\n\nThe server uses **Deno + Hono JSX**. HTML is rendered on the server. Browser behavior is plain JavaScript, not a React client bundle. No build step or browser package CDN is required. It was started from Val Town's React/Hono template, but its unused client framework files were replaced with progressive enhancement.\n\n```\nindex.ts Hono HTTP handler and routes\nfrontend/catalog.ts Game records and both languages\nfrontend/root.tsx Page layouts and metadata\nfrontend/components/ui.tsx Reusable components, icons and artwork\nfrontend/client.js Search, favorites, player and other behavior\nfrontend/styles.css Responsive design system\nfrontend/favicon.svg Brand icon\nscripts/source-archive.ts Allowlisted source ZIP generator\nscripts/create-private-repo.sh Optional local GitHub setup\nscripts/check-live.ts Published endpoint and asset checks\ntests/verify.ts SSR and DOM behavior checks\n```\n\nThe HTTP file is `index.ts`; its custom subdomain is `tamashi.val.run`. Publishing changes in Val Town deploys them. HTML is not permanently cached; asset URLs include the current Val version so edits do not leave stale CSS or JavaScript behind.\n\nRoutes: `/ka`, `/en`, `/:lang/games`, `/:lang/games/:slug`, `/:lang/favorites`, `/:lang/about`, `/:lang/privacy`. Utility routes: `/health`, `/api/games`, `/sitemap.xml`, `/robots.txt`, `/source`, `/source.zip`.\n\n## Add or publish a game\n\n1. Add a record to `games` in `frontend/catalog.ts`, with a unique lowercase slug, both translations, category, artwork and status.\n2. Start with `status: \"planned\"`. The site renders a concept page, removes player controls and marks that page `noindex`.\n3. Implement the game separately and verify its actual deployed HTTPS endpoint. Add its URL, instructions and feature labels to the record. Set `status: \"live\"` only when it is playable.\n4. The catalog, routes and sitemap update from those records. The server's allowed iframe origins also update from live game URLs. Add a new SVG illustration to the `Artwork` component when needed.\n5. Update the home hero and launch-specific copy such as “one game” as the collection grows. These editorial strings are intentionally explicit, not fake traffic or player numbers.\n\nDo not use user-controlled URLs or HTML in game records. For a live game with a different interface language, update its structured data language and translated descriptions.\n\n## Supra Stack integration\n\nExisting project: `omriluz/supra-stack`.\n\nOriginal endpoint: https://omriluz--01a080c9879371ca822a748c007e90d2.web.val.run/\n\nThe hub leaves that game unchanged. It loads in a sandboxed iframe only after the player chooses **Load the game**. **Open original game** is always available as a fallback. The game currently has an English interface.\n\nGame progress is on the game's own origin. Browser storage partitioning can make embedded progress different from progress in a standalone tab. Existing players should open the original game to access their earlier save. Tamashi does not claim cloud save or cross-device synchronization.\n\n## Privacy and access\n\nTamashi stores only two local preference keys: `tamashi:favorites:v1` and `tamashi:recent:v1`. Its privacy-page button removes only those keys, never all local storage or Supra Stack's saves. Storage-disabled browsers remain usable.\n\nThere are no trackers or browser font/image CDNs. Val Town may still process ordinary hosting request data. Loading Supra Stack makes a request to that game's separate origin.\n\n**Important:** this Val Town project has public source code because the current destination account is on the Free tier. A private GitHub repository does not change Val Town source visibility. No secrets should ever be added to source; use project environment variables for future integrations. Review the site's privacy text before adding analytics, ads, authentication or any other data collection.\n\n## GitHub status and setup\n\nThe connected GitHub tool can write files to existing repositories but does **not** offer repository creation. Therefore the requested private `omriluz/tamashi` GitHub repository has **not** been created or populated by this deployment. No automatic GitHub-to-Val-Town sync has been configured.\n\nDownload `/source.zip` to get a repository-ready snapshot. After extracting it, an authenticated GitHub CLI user can run:\n\n```sh\nbash scripts/create-private-repo.sh\n```\n\nThat script verifies the GitHub account is `omriluz`, initializes a local Git repository if needed, commits this source, creates a **private** `omriluz/tamashi` repository and pushes. It stops instead of overwriting an existing remote or repository. It does not ask for tokens in chat. Alternatively create an empty private `tamashi` repository on GitHub and use the connected GitHub file tools to commit this source.\n\n## Verification\n\nRun `tests/verify.ts` as a **script in Val Town**. It checks localized routes, canonical URLs, actual 404 status codes, translation-key parity, safe concept pages, filters, bilingual search, favorites, local storage denial, recent games, iframe creation and selective preference clearing.\n\nRun `scripts/check-live.ts` to verify the published pages, actual asset URLs, the original game's response and iframe compatibility headers. The DOM test environment is not a full visual browser or a gameplay test. Native fullscreen and share dialogs should additionally be reviewed on target mobile devices.\n\nBefore launch, have a fluent Georgian speaker review the copy and test on the intended Georgian audience's devices. Future work: more actual games, an original social-preview image, production domain, consent-aware monetization and optional analytics. No donation or leaderboard claims are made by this skeleton.\n","createdAt",["D",1789246999268],"branchVersion","branchId","b78feb9a-30b5-4c95-808e-1e5877f2136d","id","9d8fcd21-b516-4723-90dd-f3d65d0a9728","tamashi",["D",1789245397689],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","Georgian-first browser game hub. Play a little closer to home.","imageUrl","f5be24e4-c798-4816-91e5-037b60b986f5","pinnedFileId","01a09756-1b07-73f6-b585-4e51d6e115f6","pinPreview",true,"pinMigrated","screenshotVersion","likeCount",0,"orgId","7f67379d-2d38-49bd-81ac-2c7f92a739e2","tursoName","9d8fcd21b516472390ddf3d65d0a9728","tursoHostname","9d8fcd21b516472390ddf3d65d0a9728-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789506649022],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_99":98,"_106":102},"org",{"_99":98,"_100":-5,"_101":102,"_18":54,"_103":104,"_105":25},"branch",{"_13":88,"_32":89,"_42":41,"_90":43,"_91":-5,"_92":-5,"_93":-5,"_94":-5,"_95":-5,"_96":44,"_97":98},"isOwned",28,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","omriluz","handle","displayName","avatar","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvb2F1dGhfZ2l0aHViL2ltZ18ycWxkOWxiOE00SkVtZENmRWM4YWxLWTRVUFMifQ","tier","free","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_42":43,"_32":44,"_37":291,"_46":-5,"_47":25,"_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":292,"_71":-5,"_72":73,"_74":73,"_75":76,"_77":76,"_78":76,"_79":73,"_80":73,"_81":293,"_83":294,"_85":295,"_87":25},"tree",[177,188,190,191,192],"files",[177,178,179,180,181,182,183,184,185,186,187,188,189,190,191,192],"counts",{"_166":62,"_167":168,"_169":62,"_170":171,"_172":173},"contents",[129,130,131,132,133],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_42":161,"_32":162,"_30":163,"_136":-5,"_40":41,"_39":140,"_138":58,"_37":164,"_13":62,"_33":159,"_34":-5,"_24":25,"_143":-5,"_27":165},{"_42":154,"_32":155,"_30":156,"_136":-5,"_40":41,"_39":157,"_138":58,"_37":158,"_13":62,"_33":159,"_34":-5,"_24":25,"_143":-5,"_27":160},{"_42":148,"_32":149,"_30":150,"_136":-5,"_40":41,"_39":140,"_138":25,"_37":151,"_13":62,"_33":20,"_34":152,"_24":25,"_143":-5,"_27":153},{"_42":145,"_32":28,"_30":31,"_136":-5,"_40":41,"_39":14,"_138":25,"_37":146,"_13":140,"_33":20,"_34":36,"_24":25,"_143":-5,"_27":147},{"_42":134,"_32":135,"_30":56,"_136":-5,"_40":41,"_39":137,"_138":25,"_37":139,"_13":140,"_33":141,"_34":142,"_24":25,"_143":44,"_27":144},"3860e7a8-4ff6-411f-9228-3c21e49a1ed9","index.ts","parentId",7,"latest",["D",1789246723065],1,"http","import { Hono } from \"npm:hono@4\";\nimport { parseVal, serveImmutableFile, immutableFileUrl } from \"https://esm.town/v/std/utils/index.ts\";\nimport { Root, SITE_URL, type Page } from \"./frontend/root.tsx\";\nimport { games, bySlug, type Lang } from \"./frontend/catalog.ts\";\n\nexport const app = new Hono();\nconst GAME_ORIGINS = [...new Set(games.filter(game => game.status === \"live\" && game.url).map(game => new URL(game.url!).origin))];\napp.use(\"*\", async (c, next) => {\n c.header(\"X-Content-Type-Options\", \"nosniff\");\n c.header(\"Referrer-Policy\", \"strict-origin-when-cross-origin\");\n c.header(\"Permissions-Policy\", \"camera=(), microphone=(), geolocation=()\");\n c.header(\"Content-Security-Policy\", `default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self' data:; font-src 'self'; connect-src 'self'; frame-src ${GAME_ORIGINS.join(\" \")}; object-src 'none'; base-uri 'self'; form-action 'self'`);\n await next();\n if (c.res.headers.get(\"content-type\")?.includes(\"text/html\")) {\n c.header(\"Cache-Control\", \"no-cache\");\n c.header(\"Content-Language\", c.req.path.startsWith(\"/en\") ? \"en\" : \"ka\");\n }\n});\n\n// Assets are version-addressed, so each publish invalidates browser caches.\napp.get(\"/__immutable/*\", c => serveImmutableFile(c.req.path));\napp.get(\"/source\", c => c.redirect(parseVal().links.self.val));\napp.get(\"/favicon.ico\", c => c.redirect(immutableFileUrl(\"/frontend/favicon.svg\")));\napp.get(\"/\", c => c.redirect(\"/ka\", 302));\napp.get(\"/health\", c => c.json({status:\"ok\", app:\"tamashi\", version:\"0.1.0\", languages:[\"ka\",\"en\"], playableGames:games.filter(game=>game.status===\"live\").length, conceptGames:games.filter(game=>game.status===\"planned\").length}));\napp.get(\"/api/games\", c => c.json({games:games.map(game=>({slug:game.slug,title:game.title,description:game.description,category:game.category,status:game.status,paths:{ka:`/ka/games/${game.slug}`,en:`/en/games/${game.slug}`}}))}));\napp.get(\"/robots.txt\", c => c.text(`User-agent: *\\nAllow: /\\nDisallow: /api/\\nDisallow: /health\\nSitemap: ${SITE_URL}/sitemap.xml\\n`));\napp.get(\"/sitemap.xml\", c => {\n const paths = [\"\", \"/games\", \"/about\", \"/privacy\", ...games.filter(game=>game.status===\"live\").map(game=>`/games/${game.slug}`)];\n const entries = ([\"ka\",\"en\"] as const).flatMap(lang=>paths.map(path=>`${SITE_URL}/${lang}${path}`)).join(\"\");\n return c.body(`${entries}`, 200, {\"Content-Type\":\"application/xml; charset=utf-8\"});\n});\nfor (const lang of [\"ka\", \"en\"] as const) {\n app.get(`/${lang}`, c => c.html(Root({lang,page:\"home\"})));\n app.get(`/${lang}/`, c => c.redirect(`/${lang}`, 308));\n for (const page of [\"games\", \"favorites\", \"about\", \"privacy\"] as const) {\n app.get(`/${lang}/${page}`, c => c.html(Root({lang,page})));\n app.get(`/${lang}/${page}/`, c => c.redirect(`/${lang}/${page}`, 308));\n }\n app.get(`/${lang}/games/:slug`, c => {\n const game = bySlug(c.req.param(\"slug\"));\n return game ? c.html(Root({lang,page:\"game\",game})) : c.html(Root({lang,page:\"404\"}),404);\n });\n}\napp.notFound(c => c.req.path.startsWith(\"/api/\") ? c.json({error:\"Not found\"},404) : c.html(Root({lang:c.req.path.startsWith(\"/en\")?\"en\":\"ka\",page:\"404\"}),404));\napp.onError((error,c) => {\n console.error(\"Tamashi request error:\", error.message);\n return c.text(\"Tamashi is temporarily unavailable. Please try again.\",500);\n});\nexport default app.fetch;\n","label",[135],"deb3d6f9-d2d4-429e-9cb3-a7b37f918de8",["D",1789246999268],[28],"e839b501-66ef-425c-9925-4093724af074","CHANGELOG.md","01a09756-1b07-73f6-b585-477c43ba5981",["D",1789245397689],"# 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 }

{page===\"home\"?:page===\"games\"?<>:page===\"favorites\"?<>:page===\"game\"&&game?:page===\"about\"?:page===\"privacy\"?:

{t.notFound}

{t.notFoundBody}

{t.backHome}

}

Diff · v10