[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_291":292,"_293":294},"routes/_app.x.$handle.$name",{"_98":97,"_32":44,"_107":84,"_27":108,"_13":14,"_109":-5,"_11":110,"_111":112,"_113":114,"_115":116,"_117":118,"_20":-5,"_119":120,"_121":122,"_123":25,"_124":125,"_126":57,"_127":-5,"_128":-5,"_129":130},"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":-5,"_52":-5,"_18":53,"_54":55,"_56":57,"_58":57,"_59":-5,"_60":61,"_62":63,"_64":-5,"_65":-5,"_66":-5,"_67":-5,"_68":69,"_70":69,"_71":72,"_73":72,"_74":72,"_75":69,"_76":69,"_77":78,"_79":80,"_81":82,"_83":25},"version",12,"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","0199baef-30cb-751c-ae2f-7a80d2974e59","name","fileType","content","# React Router Hono Starter\n\nMinimal React Router + Hono starter example in [\"data mode\"][modes] with server-side rendering for Val Town\n\n[View demo][demo]\n\n## How it works\n\nThe `server.tsx` file is the main server that responds with an HTML stream, using React Router, or an API response.\nThe HTML includes a `` 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- **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@85-main/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\n",[187],"6b6a26b8-a2e8-11f0-8bfa-0224a6c84d84",".vtignore","6b6a2780-a2e8-11f0-8bfa-0224a6c84d84",3,["D",1759777956649],".git\n.vscode\n.cursorrules\n.DS_Store\nnode_modules\nvendor",[194],"7a22b166-a2e8-11f0-bec1-0224a6c84d84","frontend","7a22b260-a2e8-11f0-bec1-0224a6c84d84",7,["D",1759777981362],"directory",[201],"6f13aeec-a2e8-11f0-bd1e-0224a6c84d84","backend","6f13afdc-a2e8-11f0-bd1e-0224a6c84d84",5,["D",1759777962769],[208],"pulls","branches","forks","envVars",{"_220":61,"_222":61},"connections",{"_220":61,"_221":61},"count","unfilledCount","emptyCount",{"_42":207,"_32":208,"_30":209,"_154":-5,"_40":41,"_39":210,"_156":57,"_37":284,"_13":61,"_33":205,"_34":-5,"_24":25,"_161":-5,"_236":285,"_27":286},{"_42":276,"_32":277,"_30":278,"_154":209,"_40":41,"_39":279,"_156":57,"_37":280,"_13":61,"_33":168,"_34":281,"_24":25,"_161":-5,"_236":282,"_27":283},{"_42":200,"_32":201,"_30":202,"_154":-5,"_40":41,"_39":203,"_156":57,"_37":273,"_13":61,"_33":205,"_34":-5,"_24":25,"_161":-5,"_236":274,"_27":275},{"_42":265,"_32":266,"_30":267,"_154":202,"_40":41,"_39":268,"_156":57,"_37":269,"_13":61,"_33":20,"_34":270,"_24":25,"_161":-5,"_236":271,"_27":272},{"_42":257,"_32":258,"_30":259,"_154":202,"_40":41,"_39":260,"_156":57,"_37":261,"_13":61,"_33":168,"_34":262,"_24":25,"_161":-5,"_236":263,"_27":264},{"_42":193,"_32":194,"_30":195,"_154":-5,"_40":41,"_39":196,"_156":57,"_37":254,"_13":61,"_33":20,"_34":198,"_24":25,"_161":-5,"_236":255,"_27":256},{"_42":186,"_32":187,"_30":188,"_154":-5,"_40":41,"_39":189,"_156":57,"_37":251,"_13":61,"_33":20,"_34":191,"_24":25,"_161":-5,"_236":252,"_27":253},{"_42":183,"_32":28,"_30":31,"_154":-5,"_40":41,"_39":14,"_156":57,"_37":248,"_13":166,"_33":20,"_34":36,"_24":25,"_161":-5,"_236":249,"_27":250},{"_42":177,"_32":178,"_30":179,"_154":-5,"_40":41,"_39":166,"_156":57,"_37":245,"_13":61,"_33":168,"_34":181,"_24":25,"_161":-5,"_236":246,"_27":247},{"_42":171,"_32":172,"_30":173,"_154":-5,"_40":41,"_39":158,"_156":57,"_37":242,"_13":61,"_33":20,"_34":175,"_24":25,"_161":-5,"_236":243,"_27":244},{"_42":163,"_32":164,"_30":165,"_154":-5,"_40":41,"_39":166,"_156":57,"_37":239,"_13":61,"_33":168,"_34":169,"_24":25,"_161":-5,"_236":240,"_27":241},{"_42":152,"_32":153,"_30":55,"_154":-5,"_40":41,"_39":155,"_156":57,"_37":235,"_13":158,"_33":159,"_34":160,"_24":25,"_161":-5,"_236":237,"_27":238},["D",1759778105543],"children",[],[153],["D",1759777861761],[],[164],["D",1759777956636],[],[172],["D",1759777861761],[],[178],["D",1759778105618],[],[28],["D",1759777956637],[],[187],["D",1759777956649],[],[194],"810ca7fc-a2e8-11f0-ba70-0224a6c84d84","index.tsx","810ca8ce-a2e8-11f0-ba70-0224a6c84d84",9,["D",1759777992944],"const jokeElement = document.getElementById(\"joke\") as HTMLParagraphElement;\nconst generateBtn = document.getElementById(\"generateBtn\") as HTMLButtonElement;\nconst loadingElement = document.getElementById(\"loading\") as HTMLDivElement;\n\nasync function generateJoke() {\n // Disable button and show loading\n generateBtn.disabled = true;\n loadingElement.classList.remove(\"hidden\");\n\n try {\n const response = await fetch(\"/api/joke\");\n\n if (!response.ok) {\n throw new Error(\"Failed to fetch joke\");\n }\n\n const data = await response.json();\n jokeElement.textContent = data.joke;\n } catch (error) {\n jokeElement.textContent = \"Oops! Couldn't fetch a joke. Try again!\";\n console.error(\"Error fetching joke:\", error);\n } finally {\n // Re-enable button and hide loading\n generateBtn.disabled = false;\n loadingElement.classList.add(\"hidden\");\n }\n}\n\n// Add click event listener\ngenerateBtn.addEventListener(\"click\", generateJoke);\n\n// Optional: Generate a joke on page load\ngenerateJoke();\n",[],[201,258],"7a3786e0-a2e8-11f0-a313-0224a6c84d84","index.html","7a378780-a2e8-11f0-a313-0224a6c84d84",8,["D",1759777981497],"\n\n\n \n \n Dad Joke Generator\n \n \n\n\n

👨

Dad Joke Generator

Prepare yourself for maximum cheesiness

\n\n

\n Click the button to get a dad joke!\n

\n\n

\n \n Generate Dad Joke\n \n

\n\n

\n Loading joke...\n

\n\n \n\n\n",[],[201,266],["D",1759777981362],[226,227],[201],"6f2c510e-a2e8-11f0-b3a3-0224a6c84d84","index.ts","6f2c51d6-a2e8-11f0-b3a3-0224a6c84d84",6,["D",1759777962960],"import { Hono } from \"npm:hono@4\";\nimport { OpenAI } from \"https://esm.town/v/std/openai\";\nimport { readFile, serveFile } from \"https://esm.town/v/std/utils@85-main/index.ts\";\n\nconst app = new Hono();\n\n// Unwrap Hono errors to see original error details\napp.onError((err, c) => {\n throw err;\n});\n\n// Serve frontend files\napp.get(\"/frontend/*\", c => serveFile(c.req.path, import.meta.url));\n\n// Serve index.html\napp.get(\"/\", async c => {\n const html = await readFile(\"/frontend/index.html\", import.meta.url);\n return c.html(html);\n});\n\n// API endpoint to generate dad jokes\napp.get(\"/api/joke\", async c => {\n const openai = new OpenAI();\n\n const completion = await openai.chat.completions.create({\n messages: [\n {\n role: \"system\",\n content: \"You are a dad joke generator. Generate one short, cheesy dad joke. Return only the joke text, nothing else.\"\n },\n {\n role: \"user\",\n content: \"Tell me a dad joke\"\n },\n ],\n model: \"gpt-4o-mini\",\n max_tokens: 100,\n });\n\n const joke = completion.choices[0]?.message?.content || \"Why don't scientists trust atoms? Because they make up everything!\";\n\n return c.json({ joke });\n});\n\nexport default app.fetch;\n",[],[208,277],["D",1759777962769],[224],[208],["D",1759777861761],{"_98":97,"_106":102},{"_98":97,"_99":100,"_101":102,"_18":53,"_103":104,"_105":25},{"_13":14,"_32":84,"_42":41,"_85":43,"_86":87,"_88":89,"_90":49,"_91":92,"_93":94,"_95":44,"_96":97},"ctx",{"_77":-5,"_128":324,"_325":326,"_327":328,"_329":25,"_330":25,"_331":25,"_332":57,"_333":-5,"_334":-7,"_335":-7,"_336":61,"_337":25,"_338":25,"_339":-5,"_340":25,"_341":25,"_342":25,"_343":-5},"ENV",{"_295":296,"_297":298,"_299":84,"_300":301,"_302":303,"_304":305,"_306":307,"_308":309,"_310":311,"_312":313,"_314":315,"_316":317,"_318":319,"_320":321,"_322":323},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Diff · v12