React Router Hono Starter

\n \n

\n \n \n

\n \n );\n}\n\nfunction Home () {\n const [count, setCount] = React.useState(0);\n return (\n

Hello, Home page

{count}

\n \n

\n );\n}\n\nfunction About () {\n const data = useLoaderData();\n \n return (\n

Hello, About page

{JSON.stringify(data, null, 2)}

\n )\n}\n\nasync function catsLoader () {\n const data = await fetch(API_URL)\n .then(res => res.json());\n return data;\n}\n\nexport const routes = [\n {\n Component: Layout,\n children: [\n {\n Component: Home,\n index: true,\n },\n {\n Component: About,\n path: \"about\",\n loader: catsLoader,\n },\n ]\n },\n]\n\nexport default routes;",[162],"6b65e0b2-a2e8-11f0-a03d-0224a6c84d84","deno.json","6b65e17a-a2e8-11f0-a03d-0224a6c84d84",2,["D",1759777956636],"{\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\": [\n \"https://www.val.town/types/valtown.d.ts\"\n ],\n \"lib\": [\n \"dom\",\n \"dom.iterable\",\n \"dom.asynciterable\",\n \"deno.ns\",\n \"deno.unstable\"\n ]\n },\n \"lint\": {\n \"files\": {\n \"include\": [\n \"deno:/https/esm.town/**/*\"\n ]\n },\n \"rules\": {\n \"exclude\": [\n \"no-explicit-any\"\n ]\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}",[169],"32e61fa4-a2e8-11f0-9b52-0224a6c84d84","client.tsx","0199baef-30cb-751c-ae2f-7e5adda220e6",["D",1759777861761],"/** @jsxImportSource https://esm.sh/react@19 */\nimport React from \"https://esm.sh/react@19\";\nimport ReactDOM from \"https://esm.sh/react-dom@19/client\";\nimport { createBrowserRouter, RouterProvider } from \"https://esm.sh/react-router\";\nimport routes from \"./routes.tsx\";\n\nconsole.log(\"client\");\n\nconst router = createBrowserRouter(routes);\n\nReactDOM.hydrateRoot(\n document, \n \n);",[176],"32e615ae-a2e8-11f0-9b52-0224a6c84d84","README.md","0199baef-30cb-751c-ae2f-7a80d2974e59",["D",1759777861761],"# 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",[188],"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",[195],"7a22b166-a2e8-11f0-bec1-0224a6c84d84",["D",1759777981362],[27],"6f13aeec-a2e8-11f0-bd1e-0224a6c84d84","backend","6f13afdc-a2e8-11f0-bd1e-0224a6c84d84",5,["D",1759777962769],[205],"pulls","branches","forks","envVars",{"_217":59,"_219":59},"connections",{"_217":59,"_218":59},"count","unfilledCount","emptyCount",{"_40":204,"_31":205,"_29":206,"_153":-5,"_38":39,"_37":207,"_155":55,"_35":263,"_13":59,"_32":33,"_34":-5,"_23":24,"_159":-5,"_231":264,"_26":265},{"_40":255,"_31":256,"_29":257,"_153":206,"_38":39,"_37":258,"_155":55,"_35":259,"_13":59,"_32":165,"_34":260,"_23":24,"_159":-5,"_231":261,"_26":262},{"_40":201,"_31":27,"_29":30,"_153":-5,"_38":39,"_37":14,"_155":55,"_35":252,"_13":59,"_32":33,"_34":-5,"_23":24,"_159":-5,"_231":253,"_26":254},{"_40":194,"_31":195,"_29":196,"_153":-5,"_38":39,"_37":197,"_155":55,"_35":249,"_13":59,"_32":20,"_34":199,"_23":24,"_159":-5,"_231":250,"_26":251},{"_40":187,"_31":188,"_29":189,"_153":-5,"_38":39,"_37":190,"_155":55,"_35":246,"_13":59,"_32":20,"_34":192,"_23":24,"_159":-5,"_231":247,"_26":248},{"_40":181,"_31":182,"_29":183,"_153":-5,"_38":39,"_37":154,"_155":24,"_35":243,"_13":59,"_32":20,"_34":185,"_23":24,"_159":-5,"_231":244,"_26":245},{"_40":175,"_31":176,"_29":177,"_153":-5,"_38":39,"_37":154,"_155":55,"_35":240,"_13":59,"_32":165,"_34":179,"_23":24,"_159":-5,"_231":241,"_26":242},{"_40":168,"_31":169,"_29":170,"_153":-5,"_38":39,"_37":171,"_155":55,"_35":237,"_13":59,"_32":20,"_34":173,"_23":24,"_159":-5,"_231":238,"_26":239},{"_40":161,"_31":162,"_29":163,"_153":-5,"_38":39,"_37":154,"_155":55,"_35":234,"_13":59,"_32":165,"_34":166,"_23":24,"_159":-5,"_231":235,"_26":236},{"_40":151,"_31":152,"_29":53,"_153":-5,"_38":39,"_37":154,"_155":24,"_35":230,"_13":59,"_32":157,"_34":158,"_23":24,"_159":-5,"_231":232,"_26":233},["D",1759777861761],"children",[],[152],["D",1759777861761],[],[162],["D",1759777956636],[],[169],["D",1759777861761],[],[176],["D",1759777861761],[],[182],["D",1759777956637],[],[188],["D",1759777956649],[],[195],["D",1759777981362],[],[27],"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",[],[205,256],["D",1759777962769],[221],[205],["D",1759777861761],{"_97":96,"_105":101},{"_97":96,"_98":99,"_100":101,"_18":51,"_102":103,"_104":24},{"_13":82,"_31":83,"_40":39,"_84":41,"_85":86,"_87":88,"_89":47,"_90":91,"_92":93,"_94":42,"_95":96},"ctx",{"_75":-5,"_127":303,"_304":305,"_306":307,"_308":24,"_309":24,"_310":24,"_311":55,"_312":-5,"_313":-7,"_314":-7,"_315":59,"_316":24,"_317":24,"_318":-5,"_319":24,"_320":24,"_321":24,"_322":-5},"ENV",{"_274":275,"_276":277,"_278":83,"_279":280,"_281":282,"_283":284,"_285":286,"_287":288,"_289":290,"_291":292,"_293":294,"_295":296,"_297":298,"_299":300,"_301":302},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","811aa22498c9b0b5a47e8d778de579cdb990f332","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 · v7