Hi

\"\n});\n```\n\n## Val Town Utility Functions\n\nVal Town provides several utility functions to help with common project tasks.\n\n### Importing Utilities\n\nAlways import utilities with version pins to avoid breaking changes:\n\n```ts\nimport { readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n```\n\n### Available Utilities\n\n\n#### **serveFile** - Serve project files with proper content types\n\nFor example, in Hono:\n\n```ts\n// serve all files in frontend/ and shared/\napp.get(\"/frontend/*\", c => serveFile(c.req.path, import.meta.url));\napp.get(\"/shared/*\", c => serveFile(c.req.path, import.meta.url));\n```\n\n#### **readFile** - Read files from within the project:\n\n```ts\n// Read a file from the project\nconst fileContent = await readFile(\"/frontend/index.html\", import.meta.url);\n```\n\n#### **listFiles** - List all files in the project\n\n```ts\nconst files = await listFiles(import.meta.url);\n```\n\n## Val Town Platform Specifics\n\n- **Redirects:** Use `return new Response(null, { status: 302, headers: { Location: \"/place/to/redirect\" }})` instead of `Response.redirect` which is broken\n- **Images:** Avoid external images or base64 images. Use emojis, unicode symbols, or icon fonts/libraries instead\n- **AI Image:** To inline generate an AI image use: `

`\n- **Storage:** DO NOT use the Deno KV module for storage\n- **Browser APIs:** DO NOT use the `alert()`, `prompt()`, or `confirm()` methods\n- **Weather Data:** Use open-meteo for weather data (doesn't require API keys) unless otherwise specified\n- **Error Debugging:** Add `` to HTML to capture client-side errors\n- **Error Handling:** Only use try...catch when there's a clear local resolution; Avoid catches that merely log or return 500s. Let errors bubble up with full context\n- **Environment Variables:** Use `Deno.env.get('keyname')` when you need to, but generally prefer APIs that don't require keys\n- **Imports:** Use `https://esm.sh` for npm and Deno dependencies to ensure compatibility on server and browser\n- **Storage Strategy:** Only use backend storage if explicitly required; prefer simple static client-side sites\n- **React Configuration:** When using React libraries, pin versions with `?deps=react@18.2.0,react-dom@18.2.0` and start the file with `/** @jsxImportSource https://esm.sh/react@18.2.0 */`\n- Ensure all React dependencies and sub-dependencies are pinned to the same version\n- **Styling:** Default to using TailwindCSS via `` unless otherwise specified\n\n## Project Structure and Design Patterns\n\n### Recommended Directory Structure\n```\n├── backend/\n│ ├── database/\n│ │ ├── migrations.ts # Schema definitions\n│ │ ├── queries.ts # DB query functions\n│ │ └── README.md\n│ └── routes/ # Route modules\n│ ├── [route].ts\n│ └── static.ts # Static file serving\n│ ├── index.ts # Main entry point\n│ └── README.md\n├── frontend/\n│ ├── components/\n│ │ ├── App.tsx\n│ │ └── [Component].tsx\n│ ├── favicon.svg\n│ ├── index.html # Main HTML template\n│ ├── index.tsx # Frontend JS entry point\n│ ├── README.md\n│ └── style.css\n├── README.md\n└── shared/\n ├── README.md\n └── utils.ts # Shared types and functions\n```\n\n### Backend (Hono) Best Practices\n\n- Hono is the recommended API framework\n- Main entry point should be `backend/index.ts`\n- Do NOT use Hono serveStatic middleware\n- **Static asset serving:** Use the utility functions to read and serve project files:\n ```ts\n import { readFile, serveFile } from \"https://esm.town/v/std/utils/index.ts\";\n\n // serve all files in frontend/ and shared/\n app.get(\"/frontend/*\", c => serveFile(c.req.path, import.meta.url));\n app.get(\"/shared/*\", c => serveFile(c.req.path, import.meta.url));\n\n // For index.html, often you'll want to bootstrap with initial data\n app.get(\"/\", async c => {\n let html = await readFile(\"/frontend/index.html\", import.meta.url);\n\n // Inject data to avoid extra round-trips\n const initialData = await fetchInitialData();\n const dataScript = ``;\n\n html = html.replace(\"\", `${dataScript}`);\n return c.html(html);\n });\n ```\n- Create RESTful API routes for CRUD operations\n- Always include this snippet at the top-level Hono app to re-throwing errors to see full stack traces:\n ```ts\n // Unwrap Hono errors to see original error details\n app.onError((err, c) => {\n throw err;\n });\n ```\n\n### Database Patterns\n- Run migrations on startup or comment out for performance\n- Change table names when modifying schemas rather than altering\n- Export clear query functions with proper TypeScript typing\n\n## Common Gotchas and Solutions\n\n1. **Environment Limitations:**\n - Val Town runs on Deno in a serverless context, not Node.js\n - Code in `shared/` must work in both frontend and backend environments\n - Cannot use `Deno` keyword in shared code\n - Use `https://esm.sh` for imports that work in both environments\n\n2. **SQLite Peculiarities:**\n - Limited support for ALTER TABLE operations\n - Create new tables with updated schemas and copy data when needed\n - Always run table creation before querying\n\n3. **React Configuration:**\n - All React dependencies must be pinned to 18.2.0\n - Always include `@jsxImportSource https://esm.sh/react@18.2.0` at the top of React files\n - Rendering issues often come from mismatched React versions\n\n4. **File Handling:**\n - Val Town only supports text files, not binary\n - Use the provided utilities to read files across branches and forks\n - For files in the project, use `readFile` helpers\n\n5. **API Design:**\n - `fetch` handler is the entry point for HTTP vals\n - Run the Hono app with `export default app.fetch // This is the entry point for HTTP vals`\n\n6. **Hono Peculiarities:**\n - NEVER EVER write this line: `import { serveStatic } from 'https://esm.sh/hono@3.11.7/middleware';`\n - Instead use: `import { readFile, serveFile } from \"https://esm.town/v/std/utils/index.ts\";`\n - NEVER EVER write this line: `import { cors } from \"https://esm.sh/@hono/cors@0.0.6\";`. \n - Val Town automatically handles CORS.\n - If you need cookies, use: import { deleteCookie, getCookie, setCookie } from \"npm:hono/cookie\";",[],[153,173,180],[153,173],[153],{"_107":192,"_100":193,"_154":194,"_156":-5,"_157":138,"_158":163,"_160":161,"_109":195,"_104":31,"_164":165,"_166":-5,"_167":27,"_168":-5,"_169":196,"_103":214},"88d01986-461f-11f0-99f5-76b3cceeab13",".vscode","8b15c243-4979-411e-bdd6-c2511c100b1b",["D",1749576170090],[197,205],{"_107":198,"_100":199,"_154":200,"_156":194,"_157":138,"_158":163,"_160":161,"_109":201,"_104":31,"_164":185,"_166":202,"_167":27,"_168":-5,"_169":203,"_103":204},"88d00f86-461f-11f0-99f5-76b3cceeab13","extensions.json","c6320a09-4927-490d-a2c4-9db7d1d92f55",["D",1749576170090],"{\n \"recommendations\": [\n \"denoland.vscode-deno\"\n ]\n}",[],[193,199],{"_107":206,"_100":207,"_154":208,"_156":194,"_157":138,"_158":209,"_160":161,"_109":210,"_104":184,"_164":185,"_166":211,"_167":27,"_168":-5,"_169":212,"_103":213},"b74ec938-461f-11f0-8b4f-76b3cceeab13","settings.json","b359f096-461f-11f0-be9c-76b3cceeab13",10,["D",1749576248169],"{\n \"deno.enable\": true\n}",[],[193,207],[193],{"_107":216,"_100":217,"_154":218,"_156":-5,"_157":138,"_158":219,"_160":161,"_109":220,"_104":163,"_164":185,"_166":221,"_167":27,"_168":-5,"_169":222,"_103":223},"221a9810-463d-11f0-ac82-76b3cceeab13",".vtignore","8550d4f4-3f03-42bf-ab87-c6f8004bbcbf",19,["D",1749588882749],".git\n.vscode\n.cursor\n.DS_Store\nnode_modules\nvendor",[],[217],{"_107":225,"_100":226,"_154":227,"_156":-5,"_157":138,"_158":228,"_160":161,"_109":229,"_104":184,"_164":185,"_166":230,"_167":27,"_168":-5,"_169":231,"_103":232},"18bb1474-463e-11f0-af56-76b3cceeab13","biome.json","12940a56-463e-11f0-ac82-76b3cceeab13",25,["D",1749589296521],"{\n \"$schema\": \"https://biomejs.dev/schemas/1.9.4/schema.json\",\n \"vcs\": {\n \"enabled\": false,\n \"clientKind\": \"git\",\n \"useIgnoreFile\": false\n },\n \"files\": {\n \"ignoreUnknown\": false,\n \"ignore\": []\n },\n \"formatter\": {\n \"enabled\": true,\n \"indentStyle\": \"space\"\n },\n \"organizeImports\": {\n \"enabled\": true\n },\n \"linter\": {\n \"enabled\": true,\n \"rules\": {\n \"recommended\": true\n }\n },\n \"javascript\": {\n \"formatter\": {\n \"quoteStyle\": \"double\"\n }\n }\n}",[],[226],{"_107":234,"_100":235,"_154":236,"_156":-5,"_157":138,"_158":237,"_160":161,"_109":238,"_104":239,"_164":185,"_166":240,"_167":27,"_168":-5,"_169":241,"_103":242},"09862458-463e-11f0-af61-76b3cceeab13","deno.json","c2fd0e86-a2d3-4b03-8e72-8ababd94cc98",21,["D",1749589271007],2,"{\n \"$schema\": \"https://raw.githubusercontent.com/denoland/deno/348900b8b79f4a434cab4c74b3bc8d4d2fa8ee74/cli/schemas/config-file.v1.json\",\n \"lock\": false,\n \"compilerOptions\": {\n \"noImplicitAny\": false,\n \"strict\": false,\n \"types\": [\"https://www.val.town/types/valtown.d.ts\"],\n \"lib\": [\n \"dom\",\n \"dom.iterable\",\n \"dom.asynciterable\",\n \"deno.ns\",\n \"deno.unstable\"\n ]\n },\n \"lint\": {\n \"files\": {\n \"include\": [\"deno:/https/esm.town/**/*\"]\n },\n \"rules\": {\n \"exclude\": [\"no-explicit-any\"]\n }\n },\n \"node_modules_dir\": false,\n \"experimental\": {\n \"unstable-node-globals\": true,\n \"unstable-temporal\": true,\n \"unstable-worker-options\": true,\n \"unstable-sloppy-imports\": true\n },\n \"imports\": {\n \"@biomejs/biome\": \"npm:@biomejs/biome@^1.9.4\"\n }\n}",[],[235],"files",[151,171,178,191,197,205,215,224,233],"counts",{"_247":31,"_248":163,"_249":31,"_250":31},"pulls","branches","forks","envVars","contents",[253,256,259,262,265],{"_107":152,"_100":153,"_154":155,"_156":-5,"_157":138,"_158":159,"_160":161,"_109":254,"_104":163,"_164":165,"_166":-5,"_167":27,"_168":-5,"_103":255},["D",1749576492407],[153],{"_107":192,"_100":193,"_154":194,"_156":-5,"_157":138,"_158":163,"_160":161,"_109":257,"_104":31,"_164":165,"_166":-5,"_167":27,"_168":-5,"_103":258},["D",1749576170090],[193],{"_107":216,"_100":217,"_154":218,"_156":-5,"_157":138,"_158":219,"_160":161,"_109":260,"_104":163,"_164":185,"_166":221,"_167":27,"_168":-5,"_103":261},["D",1749588882749],[217],{"_107":225,"_100":226,"_154":227,"_156":-5,"_157":138,"_158":228,"_160":161,"_109":263,"_104":184,"_164":185,"_166":230,"_167":27,"_168":-5,"_103":264},["D",1749589296521],[226],{"_107":234,"_100":235,"_154":236,"_156":-5,"_157":138,"_158":237,"_160":161,"_109":266,"_104":239,"_164":185,"_166":240,"_167":27,"_168":-5,"_103":267},["D",1749589271007],[235],"upstreamProject",{"_107":270,"_100":101,"_115":271,"_116":-5,"_113":114,"_21":272},"a168e31a-2522-11f0-9865-569c3dd06744","Default editor file template for VT, Val Town's CLI",{"_98":273,"_133":274},"std","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvdXBsb2FkZWQvaW1nXzJVaVhpQ1BId3dscVpBbkdZVWlMNjJtcjkxWS5wbmcifQ","upstreamBranch",{"_107":141,"_109":277,"_278":279,"_100":42,"_139":270,"_104":143,"_140":280,"_142":281,"_282":-5,"_111":-5,"_131":27,"_113":114,"_148":273,"_147":101},["D",1745949111549],"updatedAt",["D",1746346108066],"a9123f0e-1d97-11f0-996b-569c3dd06744",8,"lockfileKey","emptyEnvVars","isNew","routes/_app.x.$handle.$name.code.$",{"_98":99,"_100":101,"_102":42,"_104":-7,"_103":73,"_105":287,"_149":291,"_243":319,"_185":-7,"_251":320,"_331":332,"_335":27,"_336":-5,"_337":228,"_338":31,"_339":340},{"_107":108,"_100":101,"_109":288,"_111":-5,"_112":27,"_113":114,"_115":-5,"_116":-5,"_12":117,"_118":-5,"_119":27,"_120":-5,"_121":31,"_122":123,"_124":123,"_125":126,"_127":126,"_128":126,"_129":123,"_130":123,"_131":27,"_21":289,"_135":290},["D",1749576170090],{"_98":99,"_133":134},{"_104":137,"_100":42,"_107":138,"_139":108,"_140":141,"_142":143,"_144":114,"_145":146,"_147":101,"_148":99},[292,301,310,313,316],{"_107":152,"_100":153,"_154":155,"_156":-5,"_157":138,"_158":159,"_160":161,"_109":162,"_104":163,"_164":165,"_166":-5,"_167":27,"_168":-5,"_169":293,"_103":300},[294],{"_107":172,"_100":173,"_154":174,"_156":155,"_157":138,"_158":175,"_160":161,"_109":176,"_104":163,"_164":165,"_166":-5,"_167":27,"_168":-5,"_169":295,"_103":299},[296],{"_107":179,"_100":180,"_154":181,"_156":174,"_157":138,"_158":182,"_160":161,"_109":183,"_104":184,"_164":185,"_166":186,"_167":27,"_168":-5,"_169":297,"_103":298},[],[153,173,180],[153,173],[153],{"_107":192,"_100":193,"_154":194,"_156":-5,"_157":138,"_158":163,"_160":161,"_109":195,"_104":31,"_164":165,"_166":-5,"_167":27,"_168":-5,"_169":302,"_103":309},[303,306],{"_107":198,"_100":199,"_154":200,"_156":194,"_157":138,"_158":163,"_160":161,"_109":201,"_104":31,"_164":185,"_166":202,"_167":27,"_168":-5,"_169":304,"_103":305},[],[193,199],{"_107":206,"_100":207,"_154":208,"_156":194,"_157":138,"_158":209,"_160":161,"_109":210,"_104":184,"_164":185,"_166":211,"_167":27,"_168":-5,"_169":307,"_103":308},[],[193,207],[193],{"_107":216,"_100":217,"_154":218,"_156":-5,"_157":138,"_158":219,"_160":161,"_109":220,"_104":163,"_164":185,"_166":221,"_167":27,"_168":-5,"_169":311,"_103":312},[],[217],{"_107":225,"_100":226,"_154":227,"_156":-5,"_157":138,"_158":228,"_160":161,"_109":229,"_104":184,"_164":185,"_166":230,"_167":27,"_168":-5,"_169":314,"_103":315},[],[226],{"_107":234,"_100":235,"_154":236,"_156":-5,"_157":138,"_158":237,"_160":161,"_109":238,"_104":239,"_164":185,"_166":240,"_167":27,"_168":-5,"_169":317,"_103":318},[],[235],[292,294,296,301,303,306,310,313,316],[321,323,325,327,329],{"_107":152,"_100":153,"_154":155,"_156":-5,"_157":138,"_158":159,"_160":161,"_109":254,"_104":163,"_164":165,"_166":-5,"_167":27,"_168":-5,"_103":322},[153],{"_107":192,"_100":193,"_154":194,"_156":-5,"_157":138,"_158":163,"_160":161,"_109":257,"_104":31,"_164":165,"_166":-5,"_167":27,"_168":-5,"_103":324},[193],{"_107":216,"_100":217,"_154":218,"_156":-5,"_157":138,"_158":219,"_160":161,"_109":260,"_104":163,"_164":185,"_166":221,"_167":27,"_168":-5,"_103":326},[217],{"_107":225,"_100":226,"_154":227,"_156":-5,"_157":138,"_158":228,"_160":161,"_109":263,"_104":184,"_164":185,"_166":230,"_167":27,"_168":-5,"_103":328},[226],{"_107":234,"_100":235,"_154":236,"_156":-5,"_157":138,"_158":237,"_160":161,"_109":266,"_104":239,"_164":185,"_166":240,"_167":27,"_168":-5,"_103":330},[235],"upstream",{"_107":141,"_109":333,"_278":334,"_100":42,"_139":270,"_104":143,"_140":280,"_142":281,"_282":-5,"_111":-5,"_131":27,"_113":114,"_148":273,"_147":101},["D",1745949111549],["D",1746346108066],"showCompareCallout","pull","ahead","behind","templates",[],"routes/_app","actionData","errors"]