\n \n \n\n",[18,88],"cfc33e96-0f86-11f1-9fc4-42dde27851f2",["D",1771720710965],[18,93],"pulls","branches","forks","envVars",{"_89":26,"_227":26},"connections",{"_89":26,"_226":26},"unfilledCount","emptyCount",{"_34":327,"_13":312,"_74":305,"_44":-5,"_36":37,"_199":41,"_200":24,"_38":328,"_40":26,"_77":94,"_202":-5,"_79":30,"_203":-5,"_248":329,"_17":330},{"_34":321,"_13":322,"_74":323,"_44":305,"_36":37,"_199":41,"_200":24,"_38":324,"_40":26,"_77":94,"_202":-5,"_79":30,"_203":-5,"_248":325,"_17":326},{"_34":313,"_13":314,"_74":315,"_44":305,"_36":37,"_199":316,"_200":24,"_38":317,"_40":97,"_77":78,"_202":318,"_79":30,"_203":-5,"_248":319,"_17":320},{"_34":303,"_13":304,"_74":125,"_44":305,"_36":37,"_199":306,"_200":24,"_38":307,"_40":90,"_77":308,"_202":309,"_79":30,"_203":-5,"_248":310,"_17":311},{"_34":198,"_13":18,"_74":113,"_44":-5,"_36":37,"_199":41,"_200":24,"_38":300,"_40":26,"_77":94,"_202":-5,"_79":30,"_203":-5,"_248":301,"_17":302},{"_34":216,"_13":93,"_74":92,"_44":113,"_36":37,"_199":41,"_200":24,"_38":297,"_40":26,"_77":94,"_202":-5,"_79":30,"_203":-5,"_248":298,"_17":299},{"_34":212,"_13":88,"_74":87,"_44":113,"_36":37,"_199":97,"_200":24,"_38":294,"_40":41,"_77":21,"_202":214,"_79":30,"_203":-5,"_248":295,"_17":296},{"_34":208,"_13":76,"_74":75,"_44":113,"_36":37,"_199":97,"_200":24,"_38":291,"_40":41,"_77":78,"_202":210,"_79":30,"_203":-5,"_248":292,"_17":293},{"_34":287,"_13":272,"_74":267,"_44":-5,"_36":37,"_199":41,"_200":24,"_38":288,"_40":26,"_77":94,"_202":-5,"_79":30,"_203":-5,"_248":289,"_17":290},{"_34":280,"_13":281,"_74":282,"_44":267,"_36":37,"_199":97,"_200":24,"_38":283,"_40":26,"_77":78,"_202":284,"_79":30,"_203":-5,"_248":285,"_17":286},{"_34":273,"_13":274,"_74":275,"_44":267,"_36":37,"_199":97,"_200":24,"_38":276,"_40":41,"_77":78,"_202":277,"_79":30,"_203":-5,"_248":278,"_17":279},{"_34":264,"_13":265,"_74":266,"_44":267,"_36":37,"_199":97,"_200":24,"_38":268,"_40":41,"_77":78,"_202":269,"_79":30,"_203":-5,"_248":270,"_17":271},{"_34":260,"_13":259,"_74":254,"_44":-5,"_36":37,"_199":41,"_200":24,"_38":261,"_40":26,"_77":94,"_202":-5,"_79":30,"_203":-5,"_248":262,"_17":263},{"_34":251,"_13":252,"_74":253,"_44":254,"_36":37,"_199":90,"_200":24,"_38":255,"_40":97,"_77":78,"_202":256,"_79":30,"_203":-5,"_248":257,"_17":258},{"_34":243,"_13":244,"_74":245,"_44":-5,"_36":37,"_199":152,"_200":24,"_38":246,"_40":90,"_77":21,"_202":247,"_79":30,"_203":-5,"_248":249,"_17":250},"7754fb6e-0fe5-11f1-af0f-42dde27851f2","README.md","019c82c8-9b9f-71cf-9c7c-38fa193b361b",["D",1771761364903],"# React Router 7 on Val Town — Minimal Example\n\nThe simplest possible full-stack SSR + SPA app on [Val Town](https://val.town),\nbuilt with **React Router 7**, **Hono**, and **SQLite**. A todo list in ~150\nlines of app code that demonstrates every core pattern you need.\n\n> **Want the full version?** See the\n> [message board example](https://www.val.town/x/stevekrouse/reactRouter7Example)\n> with nested routes, search, multiple tables, and more.\n\n## What This Teaches\n\n1. **SSR + Hydration** — Server renders full HTML, client hydrates with\n `hydrateRoot`\n2. **Shared route tree** — Same `routes.ts` on server and client;\n `serverLoader`/`serverAction` keeps DB code off the client\n3. **Single-fetch `dataStrategy`** — One request per navigation via\n `X-Data-Request` header\n4. **Loaders** — Server-side data loading before render\n5. **Actions** — Form submissions via `

` with `intent`\n pattern\n6. **SQLite persistence** — Val Town's project-scoped database\n7. **Loading states** — `useNavigation()` for optimistic UI\n\n## Project Structure\n\n```\n├── backend/\n│ ├── index.ts # Hono HTTP entry — SSR + data API + static files\n│ └── database.ts # Schema + all queries (one file, one table)\n├── frontend/\n│ ├── index.html # HTML shell template\n│ └── index.tsx # Client hydration + dataStrategy\n├── routes/\n│ ├── Home.tsx # The entire UI — todo list + add form\n│ ├── Home.loader.ts # Loads all todos from SQLite\n│ └── Home.action.ts # Handles \"add\" and \"toggle\" form submissions\n├── shared/\n│ └── routes.ts # Route tree (shared between server + client)\n└── README.md\n```\n\n## How It Works\n\n### Request Lifecycle\n\n```\nFirst visit (SSR):\n Browser → GET / → Hono → createStaticHandler → runs Home.loader\n → renderToString → full HTML response → Browser hydrates\n\nAfter hydration (SPA):\n User submits form → dataStrategy → POST / (X-Data-Request: true)\n → Hono → runs Home.action + Home.loader → JSON response\n → React Router updates UI\n```\n\n### Key Pattern: `serverLoader` / `serverAction`\n\nThe route tree in `shared/routes.ts` is imported by both server and client. The\nhelpers make this work:\n\n- **On the server**: dynamically import the real loader/action and call it\n- **On the client**: return a no-op stub (the `dataStrategy` handles fetching)\n\nThis means loader/action code and database dependencies **never ship to the\nbrowser**.\n\n### Key Pattern: `dataStrategy` (Single-Fetch)\n\nInstead of React Router calling each loader individually on the client, a custom\n`dataStrategy` in `frontend/index.tsx` makes **one HTTP request** with an\n`X-Data-Request: true` header. The server runs all matched loaders/actions and\nreturns their data as keyed JSON.\n\n## Extending This\n\n| Want to add... | What to do |\n| -------------------------- | ------------------------------------------------------------------------- |\n| **More pages** | Add routes to `shared/routes.ts` with new `Component`, `loader`, `action` |\n| **Nested layouts** | Use `children` array in routes + `` in parent component |\n| **More tables** | Add queries to `backend/database.ts` (or split into separate files) |\n| **Search** | Add a route with a loader that reads `new URL(request.url).searchParams` |\n| **Redirects from actions** | Return `redirect(\"/path\")` — the `dataStrategy` handles it automatically |\n\n## Getting Started\n\n1. **Fork this val** on Val Town\n2. The database auto-initializes on first request\n3. Visit the HTTP endpoint to see the app\n4. Start extending!\n\n## Tech Stack\n\n| Layer | Technology |\n| -------- | ---------------------------------------------- |\n| Server | [Hono](https://hono.dev/) |\n| Routing | [React Router 7](https://reactrouter.com/) |\n| UI | [React 18](https://react.dev/) |\n| Styling | [Twind](https://twind.dev/) (Tailwind via CDN) |\n| Database | Val Town SQLite (`std/sqlite`) |\n| Runtime | Val Town (Deno) |","children",[],[244],"e9d0d9c0-0fe4-11f1-96d1-42dde27851f2","routes.ts","019c82c8-9b9f-71cf-9c7c-2fe5fa5c6c26","019c82c8-9b9f-71cf-9c7c-34e7e0ef4ba1",["D",1771761127478],"import {\n type ActionFunctionArgs,\n type LoaderFunctionArgs,\n} from \"https://esm.sh/react-router@7.5.0?deps=react@18.2.0,react-dom@18.2.0\";\nimport { Home } from \"../routes/Home.tsx\";\n\nconst isServer = typeof document === \"undefined\";\n\n// On the server, dynamically import the real loader/action function.\n// On the client, return a no-op stub. The stub's presence tells React Router\n// this route needs data, but the client's dataStrategy handles the actual\n// fetching via a single HTTP request to the server.\nfunction serverLoader(importURL: string) {\n if (isServer) {\n return async (args: LoaderFunctionArgs) => {\n let module = await import(importURL);\n return (module.loader || module.default)(args);\n };\n }\n return () => null;\n}\n\nfunction serverAction(importURL: string) {\n if (isServer) {\n return async (args: ActionFunctionArgs) => {\n let module = await import(importURL);\n return (module.action || module.default)(args);\n };\n }\n return () => null;\n}\n\nexport const routes = [\n {\n path: \"/\",\n Component: Home,\n loader: serverLoader(\"../routes/Home.loader.ts\"),\n action: serverAction(\"../routes/Home.action.ts\"),\n },\n];",[],[259,252],"shared","cfdb6138-0f86-11f1-9fc4-42dde27851f2",["D",1771720710965],[241],[259],"caa29154-0f87-11f1-9965-42dde27851f2","Home.tsx","019c82c8-9b9f-71cf-9c7c-0b560a296e73","019c82c8-9b9f-71cf-9c7c-2a606343932c",["D",1771721131961],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\nimport {\n Form,\n useLoaderData,\n useNavigation,\n} from \"https://esm.sh/react-router@7.5.0?deps=react@18.2.0,react-dom@18.2.0\";\nimport React from \"https://esm.sh/react@18.2.0\";\nimport type { Todo } from \"../backend/database.ts\";\n\nexport function Home() {\n const { todos } = useLoaderData<{ todos: Todo[] }>();\n const navigation = useNavigation();\n const isAdding = navigation.state === \"submitting\"\n && navigation.formData?.get(\"intent\") === \"add\";\n const $form = React.useRef(null);\n\n // Reset the form after a successful submission\n React.useEffect(() => {\n if (navigation.state === \"idle\") $form.current?.reset();\n }, [navigation.state]);\n\n return (\n

Todo List

\n\n {/* Add todo form */}\n \n \n \n \n {isAdding ? \"Adding...\" : \"Add\"}\n \n \n\n {/* Todo list */}\n

\n
\n \n \n \n
\n \n {todo.text}\n \n

\n\n {todos.length === 0 && (\n

No todos yet. Add one above!

\n )}\n\n \n

\n );\n}\n",[],[272,265],"routes","caa28e70-0f87-11f1-9965-42dde27851f2","Home.loader.ts","019c82c8-9b9f-71cf-9c7c-04590b996403",["D",1771721131961],"import { getAllTodos } from \"../backend/database.ts\";\n\nexport async function loader() {\n return { todos: await getAllTodos() };\n}\n",[],[272,274],"caa20af4-0f87-11f1-9965-42dde27851f2","Home.action.ts","caa20b80-0f87-11f1-9965-42dde27851f2",["D",1771721131961],"import { ActionFunctionArgs } from \"https://esm.sh/react-router@7.5.0?deps=react@18.2.0,react-dom@18.2.0\";\nimport { addTodo, toggleTodo } from \"../backend/database.ts\";\n\nexport async function action({ request }: ActionFunctionArgs) {\n const formData = await request.formData();\n const intent = formData.get(\"intent\");\n\n if (intent === \"add\") {\n const text = formData.get(\"text\") as string;\n if (!text?.trim()) throw new Response(\"Text is required\", { status: 400 });\n await addTodo(text.trim());\n } else if (intent === \"toggle\") {\n const id = Number(formData.get(\"id\"));\n await toggleTodo(id);\n }\n\n return { ok: true };\n}\n",[],[272,281],"cfdb4946-0f86-11f1-9fc4-42dde27851f2",["D",1771720710965],[237,238,239],[272],["D",1771721131961],[],[18,76],["D",1771721131961],[],[18,88],["D",1771720710965],[],[18,93],["D",1771720710965],[233,234,235],[18],"2c4b5474-0fe5-11f1-bd9e-42dde27851f2","index.ts","019c82c8-9b9f-71cf-9c7b-d55bf5e7243f",5,["D",1771761239006],"http","import { Hono } from \"https://esm.sh/hono@4.1.0\";\nimport { renderToString } from \"https://esm.sh/react-dom@18.2.0/server\";\nimport {\n createStaticHandler,\n createStaticRouter,\n StaticRouterProvider,\n} from \"https://esm.sh/react-router@7.5.0?deps=react@18.2.0,react-dom@18.2.0\";\nimport React from \"https://esm.sh/react@18.2.0\";\nimport { readFile, serveFile } from \"https://esm.town/v/std/utils/index.ts\";\nimport { routes } from \"../shared/routes.ts\";\nimport { initializeDatabase } from \"./database.ts\";\n\n// Initialize the database\nawait initializeDatabase();\n\n// Create the Hono app\nconst app = new Hono();\n\n// Serve static files (frontend, shared, routes — needed for client-side imports)\napp.get(\"/frontend/*\", (c) => serveFile(c.req.path, import.meta.url));\napp.get(\"/shared/*\", (c) => serveFile(c.req.path, import.meta.url));\napp.get(\"/routes/*\", (c) => serveFile(c.req.path, import.meta.url));\napp.get(\"/backend/*\", (c) => serveFile(c.req.path, import.meta.url));\n\n// Create a static handler for server-side rendering\nconst { query, dataRoutes } = createStaticHandler(routes);\n\n// Handle all routes with React Router\napp.all(\"*\", async (c) => {\n const isDataRequest = c.req.header(\"X-Data-Request\") === \"true\";\n\n // Run loaders/actions on the server\n const context = await query(c.req.raw);\n\n // If the context is a Response (e.g., redirect from an action)\n if (context instanceof Response) {\n if (isDataRequest && context.status >= 300 && context.status < 400) {\n return Response.json({ redirect: context.headers.get(\"Location\") });\n }\n return context;\n }\n\n // Data-only request: return loader/action data as JSON\n if (isDataRequest) {\n return Response.json({\n loaderData: context.loaderData,\n actionData: context.actionData,\n });\n }\n\n // Full SSR render\n const router = createStaticRouter(dataRoutes, context);\n let html = await readFile(\"/frontend/index.html\", import.meta.url);\n\n const appHtml = renderToString(\n React.createElement(StaticRouterProvider, { router, context }),\n );\n\n html = html.replace(\n '

',\n `

${appHtml}

`,\n );\n\n return c.html(html);\n});\n\napp.onError((e) => Promise.reject(e));\n\nexport default app.fetch;",[],[312,304],"backend","3af94f9e-0fe5-11f1-ae77-42dde27851f2","database.ts","caa1e966-0f87-11f1-9965-42dde27851f2",7,["D",1771761263634],"import { sqlite } from \"https://esm.town/v/std/sqlite/main.ts\";\n\nconst TABLE = \"todos_v1\";\n\nexport interface Todo {\n id: number;\n text: string;\n done: number; // 0 or 1 (SQLite has no booleans)\n}\n\nexport async function initializeDatabase() {\n await sqlite.execute(`\n CREATE TABLE IF NOT EXISTS ${TABLE} (\n id INTEGER PRIMARY KEY AUTOINCREMENT,\n text TEXT NOT NULL,\n done INTEGER NOT NULL DEFAULT 0\n )\n `);\n}\n\nexport async function getAllTodos(): Promise {\n const result = await sqlite.execute(\n `SELECT * FROM ${TABLE} ORDER BY id DESC`,\n );\n return result.rows as unknown as Todo[];\n}\n\nexport async function addTodo(text: string): Promise {\n await sqlite.execute({\n sql: `INSERT INTO ${TABLE} (text) VALUES (?)`,\n args: [text],\n });\n}\n\nexport async function toggleTodo(id: number): Promise {\n await sqlite.execute({\n sql: `UPDATE ${TABLE} SET done = 1 - done WHERE id = ?`,\n args: [id],\n });\n}",[],[312,314],"cfc2f0bc-0f86-11f1-9fc4-42dde27851f2","database","019c82c8-9b9f-71cf-9c7b-cea6edb6ef75",["D",1771720710965],[],[312,322],"cfc30502-0f86-11f1-9fc4-42dde27851f2",["D",1771720710965],[229,230,231],[312],["D",1771720710965],["D",1789531852468],{"_11":12,"_167":82},{"_11":12,"_163":-5,"_81":82,"_31":80,"_164":165,"_166":30},{"_40":152,"_13":16,"_34":37,"_153":115,"_154":71,"_155":156,"_157":119,"_158":159,"_160":43,"_161":14,"_162":12},"ctx",{"_53":-5,"_188":369,"_370":371,"_372":373,"_374":30,"_375":30,"_376":30,"_377":24,"_378":-5,"_379":-7,"_380":-7,"_381":26,"_382":30,"_383":30,"_384":-5,"_385":30,"_386":30,"_387":30,"_388":-5},"ENV",{"_340":341,"_342":343,"_344":16,"_345":346,"_347":348,"_349":350,"_351":352,"_353":354,"_355":356,"_357":358,"_359":360,"_361":362,"_363":364,"_365":366,"_367":368},"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"]

History · frontend