',\n `

${appHtml}

`, // fix: inject rendered HTML, not literal\n );\n\n // Return the HTML with the appropriate headers\n return c.html(html);\n});\n\n// Unwrap Hono errors to see original error details\napp.onError((err, _c) => {\n throw err;\n});\n\n// Export the app for HTTP vals\nexport default app.fetch;\n",[],[155,197],[155],{"_103":206,"_95":207,"_156":208,"_158":-5,"_159":137,"_160":136,"_161":162,"_105":209,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":210,"_98":275},"66279f22-6135-11f0-a519-0224a6c84d84","frontend","4fda0381-3ddb-4189-aa39-fbe2671cfb88",["D",1752554242254],[211,258,267],{"_103":212,"_95":213,"_156":214,"_158":208,"_159":137,"_160":136,"_161":162,"_105":215,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":216,"_98":257},"66279a7c-6135-11f0-a519-0224a6c84d84","components","ab64eb40-1595-498e-882f-6e82e78ffcc7",["D",1752554242254],[217,225,233,241,249],{"_103":218,"_95":219,"_156":220,"_158":214,"_159":137,"_160":136,"_161":162,"_105":221,"_100":32,"_164":182,"_166":222,"_167":22,"_168":-5,"_169":223,"_98":224},"66278da2-6135-11f0-a519-0224a6c84d84","CopyEmailButton.tsx","7be14a12-e531-4216-a40b-34d140ba15b8",["D",1752554242254],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n\nimport { useState } from \"https://esm.sh/react@18.2.0\";\n\nexport function CopyEmailButton({ email }: { email: string }) {\n const [copied, setCopied] = useState(false);\n\n const handleCopy = async () => {\n await navigator.clipboard.writeText(email);\n setCopied(true);\n setTimeout(() => setCopied(false), 1200);\n };\n\n return (\n \n {copied ? \"Copied!\" : email}\n \n );\n}\n",[],[207,213,219],{"_103":226,"_95":227,"_156":228,"_158":214,"_159":137,"_160":136,"_161":162,"_105":229,"_100":32,"_164":182,"_166":230,"_167":22,"_168":-5,"_169":231,"_98":232},"66278faa-6135-11f0-a519-0224a6c84d84","EndpointInfo.tsx","dcd6d8b2-8dcf-478d-a1e3-247d79bbc40d",["D",1752554242254],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n\nimport type { GroupedValInfo } from \"../../shared/types.ts\";\nimport { CopyEmailButton } from \"./CopyEmailButton.tsx\";\nimport { GlobeIcon, MailIcon } from \"./Icons.tsx\";\n\nexport function EndpointInfo({ val }: { val: GroupedValInfo }) {\n return val.files.map((file) => (\n

\n {file.type === \"http\" ? : }\n

\n {file.type === \"email\" ? (\n \n ) : (\n \n {file.subdomain}\n \n )}\n

\n \n {file.fileName}\n \n

\n ));\n}\n",[],[207,213,227],{"_103":234,"_95":235,"_156":236,"_158":214,"_159":137,"_160":136,"_161":162,"_105":237,"_100":32,"_164":182,"_166":238,"_167":22,"_168":-5,"_169":239,"_98":240},"66279504-6135-11f0-a519-0224a6c84d84","Icons.tsx","9ee0dd2a-5caf-4936-ad2b-c40521c4efc5",["D",1752554242254],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n\nexport const MailIcon = () => (\n \n Email Icon\n \n \n \n);\n\nexport const GlobeIcon = () => (\n \n HTTP Icon\n \n \n \n \n);\n\nexport const LinkIcon = () => (\n \n Open external link\n \n \n);\n",[],[207,213,235],{"_103":242,"_95":243,"_156":244,"_158":214,"_159":137,"_160":136,"_161":162,"_105":245,"_100":32,"_164":182,"_166":246,"_167":22,"_168":-5,"_169":247,"_98":248},"662796da-6135-11f0-a519-0224a6c84d84","Nav.tsx","df1279ed-f1a2-4cf3-8b38-15444f1e4302",["D",1752554242254],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n\nimport { Link } from \"https://esm.sh/react-router@7.5.0?deps=react@18.2.0,react-dom@18.2.0\";\n\nexport function Nav() {\n return (\n

Custom Endpoints & Emails

\n \n \n \n \n Refresh\n \n

\n );\n}\n",[],[207,213,243],{"_103":250,"_95":251,"_156":252,"_158":214,"_159":137,"_160":136,"_161":162,"_105":253,"_100":32,"_164":182,"_166":254,"_167":22,"_168":-5,"_169":255,"_98":256},"662798ec-6135-11f0-a519-0224a6c84d84","ValCard.tsx","3d236cd9-ec78-4a0d-8a7f-618ccf886dc9",["D",1752554242254],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n\nimport type { GroupedValInfo } from \"../../shared/types.ts\";\nimport { EndpointInfo } from \"./EndpointInfo.tsx\";\nimport { LinkIcon } from \"./Icons.tsx\";\n\ninterface ValCardProps {\n val: GroupedValInfo;\n}\n\nexport function ValCard({ val }: ValCardProps) {\n return (\n

\n {val.valName}\n {val.valUrl && (\n \n \n \n )}\n

\n \n

\n );\n}\n",[],[207,213,251],[207,213],{"_103":259,"_95":260,"_156":261,"_158":208,"_159":137,"_160":136,"_161":162,"_105":262,"_100":32,"_164":263,"_166":264,"_167":22,"_168":-5,"_169":265,"_98":266},"66279c3e-6135-11f0-a519-0224a6c84d84","index.html","ec9ce96b-26df-4c59-864e-87095b81d64e",["D",1752554242254],"file","\n\n\n\n \n \n Custom Endpoints & Emails\n \n \n\n\n\n

\n \n\n\n",[],[207,260],{"_103":268,"_95":269,"_156":270,"_158":208,"_159":137,"_160":136,"_161":162,"_105":271,"_100":32,"_164":182,"_166":272,"_167":22,"_168":-5,"_169":273,"_98":274},"66279dc4-6135-11f0-a519-0224a6c84d84","index.tsx","8ddc575f-4eb7-468a-adc0-12fcece7dd29",["D",1752554242254],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n\nimport React from \"https://esm.sh/react@18.2.0\";\nimport { hydrateRoot } from \"https://esm.sh/react-dom@18.2.0/client\";\nimport {\n createBrowserRouter,\n RouterProvider,\n} from \"https://esm.sh/react-router@7.5.0?deps=react@18.2.0,react-dom@18.2.0\";\nimport { routes } from \"../shared/routes.ts\";\n\n// Create a browser router with the same routes as the server\n// but using the hydration data from the server render\nconst router = createBrowserRouter(routes, {\n // @ts-ignore - The window.__staticRouterHydrationData is added by the server\n hydrationData: globalThis.__staticRouterHydrationData,\n});\n\n// Hydrate the app\nconst root = document.getElementById(\"root\");\nif (!root) throw new Error(\"Root element not found\");\nhydrateRoot(\n root,\n \n \n ,\n);\n",[],[207,269],[207],{"_103":277,"_95":278,"_156":279,"_158":-5,"_159":137,"_160":136,"_161":162,"_105":280,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":281,"_98":306},"6627a710-6135-11f0-a519-0224a6c84d84","routes","47c865d7-b32e-428b-ab6c-49189f7804a3",["D",1752554242254],[282,290,298],{"_103":283,"_95":284,"_156":285,"_158":279,"_159":137,"_160":136,"_161":162,"_105":286,"_100":32,"_164":182,"_166":287,"_167":22,"_168":-5,"_169":288,"_98":289},"6627a06c-6135-11f0-a519-0224a6c84d84","App.tsx","e7b3cd9e-0ad3-4a8b-ba82-617860b6b1be",["D",1752554242254],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n\nimport {\n Outlet,\n useNavigation,\n} from \"https://esm.sh/react-router@7.5.0?deps=react@18.2.0,react-dom@18.2.0\";\nimport { Nav } from \"../frontend/components/Nav.tsx\";\n\nexport function App() {\n const navigation = useNavigation();\n const isLoading = navigation.state === \"loading\";\n return (\n

\n \n \n );\n}\n",[],[278,284],{"_103":291,"_95":292,"_156":293,"_158":279,"_159":137,"_160":136,"_161":162,"_105":294,"_100":32,"_164":182,"_166":295,"_167":22,"_168":-5,"_169":296,"_98":297},"6627a256-6135-11f0-a519-0224a6c84d84","Home.loader.ts","9ccaa8c4-681c-4c72-8783-d611983e1e02",["D",1752554242254],"import { ValTown } from \"npm:@valtown/sdk@1.6.0\";\nimport type { GroupedValInfo } from \"../shared/types.ts\";\n\nexport async function fetchValsFromAPI(): Promise {\n const vt = new ValTown();\n const grouped: Record = {};\n\n const valList = [];\n for await (const val of vt.me.vals.list({ limit: 1, offset: 0 })) {\n valList.push(val);\n }\n\n const filePromises = valList.map((val) =>\n vt.vals.files\n .retrieve(val.id, { path: \"\", recursive: true })\n .then((files) => ({ val, files })),\n );\n\n const results = await Promise.all(filePromises);\n\n for (const { val, files } of results) {\n const emailFiles = files.data.filter(\n (file) => file.type === \"email\" && file.links.endpoint,\n );\n\n const httpFiles = files.data.filter(\n (file) =>\n file.type === \"http\" &&\n !file.links.endpoint.includes(\"web.val.run\"),\n );\n\n for (const file of [...httpFiles, ...emailFiles]) {\n if (!grouped[val.name]) {\n grouped[val.name] = {\n valId: file.id,\n valName: val.name,\n valUrl: val.links.html,\n valAuthor: val.author?.username || \"unknown\",\n files: [],\n };\n }\n grouped[val.name].files.push({\n fileName: file.path,\n subdomain:\n file.type === \"http\"\n ? new URL(file.links.endpoint).hostname\n : new URL(file.links.endpoint).hostname.replace(\n \".val.run\",\n \"@val.email\",\n ),\n type: file.type ?? \"\",\n fileUrl: file.links.html,\n });\n }\n }\n\n return Object.values(grouped);\n}\n\nexport async function loader() {\n const vals = await fetchValsFromAPI();\n\n return { vals };\n}\n",[],[278,292],{"_103":299,"_95":300,"_156":301,"_158":279,"_159":137,"_160":136,"_161":162,"_105":302,"_100":32,"_164":182,"_166":303,"_167":22,"_168":-5,"_169":304,"_98":305},"6627a3fa-6135-11f0-a519-0224a6c84d84","Home.tsx","5f55de38-cbe3-442b-8026-6f8b2bc2ad75",["D",1752554242254],"/** @jsxImportSource https://esm.sh/react@18.2.0 */\n\nimport React from \"https://esm.sh/react@18.2.0\";\nimport {\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 { Nav } from \"../frontend/components/Nav.tsx\";\nimport { ValCard } from \"../frontend/components/ValCard.tsx\";\nimport type { GroupedValInfo } from \"../shared/types.ts\";\n\ninterface TopicListProps {\n vals: GroupedValInfo[];\n}\n\nexport function HomePage() {\n const navigation = useNavigation();\n const { vals } = useLoaderData();\n const $form = React.useRef(null);\n\n React.useEffect(() => {\n if (navigation.state === \"idle\" && $form.current) {\n $form.current.reset();\n }\n }, [navigation.state]);\n\n return (\n

\n {vals.length === 0 ? (\n

\n No vals yet. Create the first one!\n

\n ) : (\n

\n {vals.map((val) => (\n \n ))}\n

\n )}\n

\n );\n}\n",[],[278,300],[278],{"_103":308,"_95":309,"_156":310,"_158":-5,"_159":137,"_160":136,"_161":162,"_105":311,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":312,"_98":337},"6627ae36-6135-11f0-a519-0224a6c84d84","shared","82f4e11f-b1f3-4e11-8070-5f3acb7855cb",["D",1752554242254],[313,321,329],{"_103":314,"_95":315,"_156":316,"_158":310,"_159":137,"_160":136,"_161":162,"_105":317,"_100":32,"_164":182,"_166":318,"_167":22,"_168":-5,"_169":319,"_98":320},"6627a896-6135-11f0-a519-0224a6c84d84","routeUtils.ts","e9e315bc-2bd8-4853-8f5b-fbc96761c3c1",["D",1752554242254],"import type {\n ActionFunctionArgs,\n LoaderFunctionArgs,\n} from \"https://esm.sh/react-router@7.5.0?deps=react@18.2.0,react-dom@18.2.0\";\n\nconst isServer = typeof document === \"undefined\";\nconst isClient = !isServer;\n\n// Generic loader that forwards on requests for that page's JSON data\nasync function clientLoader({ request }: LoaderFunctionArgs) {\n const res = await fetch(request, {\n headers: {\n Accept: \"application/json\",\n },\n });\n return res.json();\n}\n\n// Generic action that forwards on requests for that page\nasync function clientAction({ request }: ActionFunctionArgs) {\n const response = await fetch(request);\n if (response.status === 302) {\n // somehow do a redirect\n }\n // if the response is json content type, parse the json and return it\n if (response.headers.get(\"Content-Type\")?.includes(\"application/json\")) {\n return response.json();\n }\n return response;\n}\n\nexport function createFullstackLoader(loaderSourceImportURL: string) {\n if (isClient) {\n return clientLoader;\n } else {\n return async (args: LoaderFunctionArgs) => {\n const module = await import(loaderSourceImportURL);\n const loader = module.loader || module.default;\n return loader(args);\n };\n }\n}\n\nexport function createFullstackAction(actionSourceImportURL: string) {\n if (isClient) {\n return clientAction;\n } else {\n return async (args: ActionFunctionArgs) => {\n const module = await import(actionSourceImportURL);\n const action = module.action || module.default;\n return action(args);\n };\n }\n}\n",[],[309,315],{"_103":322,"_95":323,"_156":324,"_158":310,"_159":137,"_160":136,"_161":162,"_105":325,"_100":32,"_164":182,"_166":326,"_167":22,"_168":-5,"_169":327,"_98":328},"6627aa80-6135-11f0-a519-0224a6c84d84","routes.ts","1979c679-833d-48c6-8ef2-353b04ac8db9",["D",1752554242254],"import { App } from \"../routes/App.tsx\";\nimport { HomePage } from \"../routes/Home.tsx\";\n\nimport { createFullstackLoader } from \"./routeUtils.ts\";\n\nexport const routes = [\n {\n path: \"/\",\n Component: App,\n children: [\n {\n index: true,\n Component: HomePage,\n loader: createFullstackLoader(\"../routes/Home.loader.ts\"),\n },\n ],\n },\n];\n",[],[309,323],{"_103":330,"_95":331,"_156":332,"_158":310,"_159":137,"_160":136,"_161":162,"_105":333,"_100":32,"_164":182,"_166":334,"_167":22,"_168":-5,"_169":335,"_98":336},"6627ac74-6135-11f0-a519-0224a6c84d84","types.ts","f1fc2689-a89f-4430-9a54-4aeb5992566b",["D",1752554242254],"/**\n * Topic model representing a discussion thread\n */\nexport interface Topic {\n id: number;\n title: string;\n createdAt: string;\n}\n\n/**\n * Message model representing a post within a topic\n */\nexport interface Message {\n id: number;\n topicId: number;\n content: string;\n createdAt: string;\n}\n\n/**\n * Search results containing matching topics and messages\n */\nexport interface SearchResults {\n topics: Topic[];\n messages: Message[];\n query: string;\n}\n\nexport interface ValInfo {\n id: string;\n fileName: string;\n author: string;\n subdomain: string;\n valName: string;\n valUrl: string;\n type?: string;\n}\n\nexport interface GroupedValInfo {\n valId: string;\n valName: string;\n valUrl: string;\n valAuthor: string;\n files: {\n fileName: string;\n subdomain: string;\n type: string;\n fileUrl: string;\n }[];\n}\n",[],[309,331],[309],{"_103":339,"_95":340,"_156":341,"_158":-5,"_159":137,"_160":136,"_161":162,"_105":342,"_100":32,"_164":263,"_166":343,"_167":22,"_168":-5,"_169":344,"_98":345},"6627af8a-6135-11f0-a519-0224a6c84d84",".vtignore","9c5c9137-e144-46de-b527-80c704e803c4",["D",1752554242254],".git\n.vscode\n.cursor\n.DS_Store\nnode_modules\nvendor",[],[340],{"_103":347,"_95":348,"_156":349,"_158":-5,"_159":137,"_160":136,"_161":162,"_105":350,"_100":32,"_164":263,"_166":351,"_167":22,"_168":-5,"_169":352,"_98":353},"6627b0ca-6135-11f0-a519-0224a6c84d84","README.md","e1866412-194f-46da-af78-8d0075a0ff62",["D",1752554242254],"# Community Message Board\n\nA simple community message board application built with React Router 7, demonstrating a full-stack approach with server-side rendering and client-side navigation.\n\n## Features\n\n- **Server-Side Rendering**: All pages are server-rendered when accessed directly\n- **Client-Side Navigation**: After initial load, navigation happens client-side\n- **Topic Management**: Create and view discussion topics\n- **Messaging System**: Post messages in topics\n- **Direct Message Links**: Link directly to specific messages via timestamps\n- **Search Functionality**: Search topics and messages with URL parameters\n- **Loading Indicators**: Visual feedback during async operations\n\n## Project Structure\n\n```\n├── backend/\n│ ├── database/\n│ │ ├── migrations.ts # Database schema\n│ │ └── queries.ts # Database queries\n│ └── index.ts # Server entry point\n├── frontend/\n│ ├── components/\n│ │ ├── LoadingSpinner.tsx\n│ │ ├── MessageForm.tsx\n│ │ ├── MessageList.tsx\n│ │ └── SearchForm.tsx\n│ ├── index.html # HTML template\n│ └── index.tsx # Client entry point\n├── routes/\n│ ├── App.tsx # Main application component\n│ ├── Home.tsx # Home page component\n│ ├── Home.loader.ts # Home page data loader\n│ ├── Topic.tsx # Topic detail component\n│ ├── Topic.loader.ts # Topic data loader\n│ ├── Topic.action.ts # Topic message creation action\n│ ├── TopicMessage.loader.ts # Direct message link loader\n│ ├── Topics.action.ts # Topic creation action\n│ ├── Search.tsx # Search results component\n│ └── Search.loader.ts # Search data loader\n└── shared/\n ├── routes.ts # Route definitions\n └── types.ts # Shared TypeScript types\n```\n\n## How It Works\n\n### Server-Side Rendering\n\nThe application uses React Router 7's `createStaticHandler`, `createStaticRouter`, and `StaticRouterProvider` to render pages on the server. When a user directly accesses a URL:\n\n1. The server receives the request\n2. It runs the appropriate loaders/actions for the matched route\n3. The page is rendered with the data and sent to the client\n4. The client hydrates the page with `createBrowserRouter` and `RouterProvider`\n\n### Client-Side Navigation\n\nAfter the initial page load, navigation happens entirely on the client:\n\n1. React Router handles link clicks and form submissions\n2. Data is fetched asynchronously using loaders and actions\n3. A loading spinner is displayed during data fetching\n4. The UI updates without a full page reload\n\n### Data Flow\n\n1. **Topics**: Stored in SQLite with title and creation timestamp\n2. **Messages**: Linked to topics with content and creation timestamp\n3. **Search**: Queries both topics and messages, with results in the URL\n\n### URL Structure\n\n- `/` - Home page with list of topics\n- `/` - Create new topic\n- `/topics/:topicId` - View a topic and its messages\n- `/topics/:topicId/messages/:messageId` - Direct link to a message\n- `/search?q=query` - Search results\n\n\n## Implementation Details\n\nThis application demonstrates a \"Val Town fullstack framework\" approach, combining:\n\n- **Hono**: For server-side routing and handling\n- **React Router 7**: For both server and client-side routing\n- **SQLite**: For data persistence\n- **TypeScript**: For type safety across the stack\n\nThe code is structured to be idiomatic and simple, serving as a reference for building full-stack applications with React Router 7. The project uses a Remix-style file naming convention with co-located components, loaders, and actions in the `/routes` directory.",[],[348],{"_103":355,"_95":356,"_156":357,"_158":-5,"_159":137,"_160":136,"_161":162,"_105":358,"_100":32,"_164":263,"_166":359,"_167":22,"_168":-5,"_169":360,"_98":361},"6627b4d0-6135-11f0-a519-0224a6c84d84","TODO.md","44d2c8cb-2bc7-4e38-8bf8-255e901dc785",["D",1752554242254],"- [ ] Get OpenTownie or Gemini or Claude or OpenAI to synthesize the core of these patterns into a prompt we can use to make more ReactRouter apps, such as...\n- [ ] Convert this or into the basic react router guest book (and preserve this forum app in another project?)\n- [ ] To what extent can these patterns be packaged up into a Val Town Router project? Would be neat to get the version pinning thing all centralized, can this as-a-library be that centralized place?",[],[356],{"_103":363,"_95":364,"_156":365,"_158":-5,"_159":137,"_160":136,"_161":162,"_105":366,"_100":32,"_164":263,"_166":367,"_167":22,"_168":-5,"_169":368,"_98":369},"6627b66a-6135-11f0-a519-0224a6c84d84","biome.json","4deab9d4-ee7d-4b15-99c1-3b88b2409058",["D",1752554242254],"{\n \"$schema\": \"https://biomejs.dev/schemas/2.0.0/schema.json\",\n \"vcs\": {\n \"enabled\": false,\n \"clientKind\": \"git\",\n \"useIgnoreFile\": false\n },\n \"files\": {\n \"ignoreUnknown\": false\n },\n \"formatter\": {\n \"enabled\": true,\n \"indentStyle\": \"space\",\n \"indentWidth\": 3\n },\n \"linter\": {\n \"enabled\": true,\n \"rules\": {\n \"recommended\": true\n }\n },\n \"javascript\": {\n \"formatter\": {\n \"quoteStyle\": \"double\"\n }\n },\n \"assist\": {\n \"enabled\": true,\n \"actions\": {\n \"source\": {\n \"organizeImports\": \"on\"\n }\n }\n }\n}",[],[364],{"_103":371,"_95":372,"_156":373,"_158":-5,"_159":137,"_160":136,"_161":162,"_105":374,"_100":32,"_164":263,"_166":375,"_167":22,"_168":-5,"_169":376,"_98":377},"6627b9da-6135-11f0-a519-0224a6c84d84","deno.json","10d526e2-2d27-46d8-a3c7-cb8c1d764525",["D",1752554242254],"{\n \"$schema\": \"https://raw.githubusercontent.com/denoland/deno/348900b8b79f4a434cab4c74b3bc8d4d2fa8ee74/cli/schemas/config-file.v1.json\",\n \"compilerOptions\": {\n \"lib\": [\n \"dom\",\n \"dom.iterable\",\n \"dom.asynciterable\",\n \"deno.ns\",\n \"deno.unstable\"\n ],\n \"noImplicitAny\": false,\n \"strict\": false,\n \"types\": [\"https://www.val.town/types/valtown.d.ts\"]\n },\n \"experimental\": {\n \"unstable-node-globals\": true,\n \"unstable-sloppy-imports\": true,\n \"unstable-temporal\": true,\n \"unstable-worker-options\": true\n },\n \"imports\": {\n \"@biomejs/biome\": \"npm:@biomejs/biome@^2.0.0\"\n },\n \"lint\": {\n \"files\": {\n \"include\": [\"deno:/https/esm.town/**/*\"]\n },\n \"rules\": {\n \"exclude\": [\"no-explicit-any\"]\n }\n },\n \"lock\": false,\n \"nodeModulesDir\": \"auto\"\n}",[],[372],{"_103":379,"_95":380,"_156":381,"_158":-5,"_159":137,"_160":136,"_161":162,"_105":382,"_100":32,"_164":263,"_166":383,"_167":22,"_168":-5,"_169":384,"_98":385},"6627bb92-6135-11f0-a519-0224a6c84d84","react-router-questions.md","9beb0720-69f2-4606-9f00-1fed033ef94a",["D",1752554242254],"# React Router Questions\n\nI have some questions about how to set up React Router 7 as a \"custom framework\". It seems like the documentation on this is mostly these two pages:\n\n1. Docs on React Router 7: [\"Custom Framework\"](https://reactrouter.com/start/data/custom)\n2. Example app on Github: [@remix-run/custom-react-router-framework-example](https://github.com/remix-run/custom-react-router-framework-example)\n\n## How I've set it up\n\nI'm using react-router 7.5.0, via esm.sh, and react 18.2.0.\n\n### Client loaders & actions\n\n[On the client, I turn loaders and actions into `fetch` calls to the backend.](https://www.val.town/x/stevekrouse/reactRouter7Example/code/shared/routes.ts) This is heavily inspired by [here in the Github example](https://github.com/remix-run/custom-react-router-framework-example/blob/main/app/routes.tsx#L14-L29).\n\n### Handling client loader & action API calls on the server\n\n[On the client, I check if the Accept header is JSON and then return the loader or action data.](https://www.val.town/x/stevekrouse/reactRouter7Example/code/backend/index.ts#L66-77) This is heavily inspired by [here in the Github example](https://github.com/remix-run/custom-react-router-framework-example/blob/main/entry.server.tsx#L12-L22).\n\n### Questions\n\n### 1. Setting loader state for multiple loaders\n\nRight now I've converted every loader into its own fetch call. This is the opposite of what frameworks refer to as \"single fetch\". However on the backend, I actually get access the full loaderData for all nested routes. I even wrote [this silly function to combine all the loaderData objects into one big object](https://www.val.town/x/stevekrouse/reactRouter7Example/code/backend/index.ts#L36-50).\n\nIdeally we should make a single loader call per navigation event, and set the internal router state. In other words, I would like to somehow reach into React Router and set this `state` here:\n\n![Screenshot 2025-04-10 at 15.03.32@2x.png](https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/23997cd0-6e12-46b5-53d8-89e2fe5a9c00/public)\n\nAnd then let `useLoaderData` funnel the correct loader data's to the correct routes via their IDs.\n\nI wonder how single fetch gets called: https://github.com/remix-run/react-router/blob/862709d44db19130daa7b5f9dcc0aec8561f3703/packages/react-router/lib/server-runtime/single-fetch.ts\n\n### 2. Action redirects\n\nWhen my backend returns a 302 from an action, how should I handle this on the frontend? For example, after you create a new topic on the home page, [I redirect you to that topic's ID](https://www.val.town/x/stevekrouse/reactRouter7Example/code/routes/Topics.action.ts#L13)\n\nHowever, I'm not sure how [to handle this on the client here](https://www.val.town/x/stevekrouse/reactRouter7Example/code/shared/routes.ts#L26).\n\nIdeally, I would do a proper React Router \"navigation\", and pass the relevant loader data along so it can be 100% client-side and require no other API calls.\n\nLooks like this is how remix the framework handles it: https://github.com/remix-run/react-router/blob/862709d44db19130daa7b5f9dcc0aec8561f3703/packages/react-router/lib/server-runtime/single-fetch.ts#L70-L80\n\n### 3. Should I use `queryRoute` instead of `query` in my server?\n\nThe [example app uses `queryRoute`](https://github.com/remix-run/custom-react-router-framework-example/blob/f5a141d67800e8da076cd1bb3130f29a8c0d4ce3/entry.server.tsx#L77-L79) instead of `query` for loaders and actions. I tried using that too but it didn't work. I think it returned undefined. I am now [using `query` for everything](https://www.val.town/x/stevekrouse/reactRouter7Example/code/backend/index.ts#L58).\n\nIs it better to use that or is my use of `query` fine? I get the feeling that `query` is doing a bunch of work I don't need, ie SRR, but maybe that's not very expensive so it's fine? I noticed [the example app uses `X-Route-ID`](https://github.com/remix-run/custom-react-router-framework-example/blob/main/app/layout.client.tsx#L8), so maybe I'd need to use that?",[],[380],"files",[153,171,177,186,195,205,211,217,225,233,241,249,258,267,276,282,290,298,307,313,321,329,338,346,354,362,370,378],"counts",{"_390":32,"_391":136,"_392":32,"_393":32},"pulls","branches","forks","envVars","contents",[396,399],{"_103":178,"_95":179,"_156":180,"_158":174,"_159":137,"_160":136,"_161":162,"_105":397,"_100":32,"_164":182,"_166":183,"_167":22,"_168":-5,"_98":398},["D",1752554242254],[155,173,179],{"_103":187,"_95":188,"_156":189,"_158":174,"_159":137,"_160":136,"_161":162,"_105":400,"_100":32,"_164":182,"_166":191,"_167":22,"_168":-5,"_98":401},["D",1752554242254],[155,173,188],{"_103":172,"_95":173,"_156":174,"_158":157,"_159":137,"_160":136,"_161":162,"_105":403,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_98":404},["D",1752554242254],[155,173],"upstreamProject",{"_103":145,"_95":96,"_111":-5,"_112":-5,"_109":110,"_23":407},{"_93":408,"_129":409},"nbbaier","https://secure.gravatar.com/avatar/0129a541b7b3574e92c4afd06c5e32da&d=identicon","upstreamBranch",{"_103":140,"_105":412,"_413":414,"_95":43,"_138":145,"_100":415,"_139":416,"_141":417,"_418":419,"_107":-5,"_150":22,"_109":110,"_149":408,"_16":147,"_148":96},["D",1752538385443],"updatedAt",["D",1755531530908],338,"f1a26f20-14cb-11f0-b108-569c3dd06744",166,"lockfileKey","1756277757801-esm.town_v_nbbaier_custom-endpoints@338-main","emptyEnvVars","isNew","flags",[],"routes/_app.x.$handle.$name.code.$",{"_93":94,"_95":96,"_97":43,"_100":-7,"_98":99,"_101":426,"_151":431,"_386":516,"_263":517,"_394":519,"_524":525,"_528":22,"_529":-5,"_530":32,"_531":532,"_533":534},{"_103":104,"_95":96,"_105":427,"_107":-5,"_108":22,"_109":110,"_111":-5,"_112":-5,"_14":113,"_114":-5,"_115":22,"_116":-5,"_117":32,"_16":118,"_119":120,"_121":120,"_122":123,"_124":123,"_125":123,"_126":120,"_127":120,"_23":428,"_131":429,"_134":430,"_150":22},["D",1752554242254],{"_93":94,"_129":130},{"_93":94,"_133":130},{"_100":136,"_95":43,"_103":137,"_138":104,"_139":140,"_141":142,"_143":110,"_144":145,"_146":147,"_148":96,"_149":94},[432,447,474,486,498,501,504,507,510,513],{"_103":154,"_95":155,"_156":157,"_158":-5,"_159":137,"_160":136,"_161":162,"_105":163,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":433,"_98":446},[434,443],{"_103":172,"_95":173,"_156":174,"_158":157,"_159":137,"_160":136,"_161":162,"_105":175,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":435,"_98":442},[436,439],{"_103":178,"_95":179,"_156":180,"_158":174,"_159":137,"_160":136,"_161":162,"_105":181,"_100":32,"_164":182,"_166":183,"_167":22,"_168":-5,"_169":437,"_98":438},[],[155,173,179],{"_103":187,"_95":188,"_156":189,"_158":174,"_159":137,"_160":136,"_161":162,"_105":190,"_100":32,"_164":182,"_166":191,"_167":22,"_168":-5,"_169":440,"_98":441},[],[155,173,188],[155,173],{"_103":196,"_95":197,"_156":198,"_158":157,"_159":137,"_160":136,"_161":162,"_105":199,"_100":32,"_164":200,"_166":201,"_167":22,"_168":-5,"_169":444,"_98":445},[],[155,197],[155],{"_103":206,"_95":207,"_156":208,"_158":-5,"_159":137,"_160":136,"_161":162,"_105":209,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":448,"_98":473},[449,467,470],{"_103":212,"_95":213,"_156":214,"_158":208,"_159":137,"_160":136,"_161":162,"_105":215,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":450,"_98":466},[451,454,457,460,463],{"_103":218,"_95":219,"_156":220,"_158":214,"_159":137,"_160":136,"_161":162,"_105":221,"_100":32,"_164":182,"_166":222,"_167":22,"_168":-5,"_169":452,"_98":453},[],[207,213,219],{"_103":226,"_95":227,"_156":228,"_158":214,"_159":137,"_160":136,"_161":162,"_105":229,"_100":32,"_164":182,"_166":230,"_167":22,"_168":-5,"_169":455,"_98":456},[],[207,213,227],{"_103":234,"_95":235,"_156":236,"_158":214,"_159":137,"_160":136,"_161":162,"_105":237,"_100":32,"_164":182,"_166":238,"_167":22,"_168":-5,"_169":458,"_98":459},[],[207,213,235],{"_103":242,"_95":243,"_156":244,"_158":214,"_159":137,"_160":136,"_161":162,"_105":245,"_100":32,"_164":182,"_166":246,"_167":22,"_168":-5,"_169":461,"_98":462},[],[207,213,243],{"_103":250,"_95":251,"_156":252,"_158":214,"_159":137,"_160":136,"_161":162,"_105":253,"_100":32,"_164":182,"_166":254,"_167":22,"_168":-5,"_169":464,"_98":465},[],[207,213,251],[207,213],{"_103":259,"_95":260,"_156":261,"_158":208,"_159":137,"_160":136,"_161":162,"_105":262,"_100":32,"_164":263,"_166":264,"_167":22,"_168":-5,"_169":468,"_98":469},[],[207,260],{"_103":268,"_95":269,"_156":270,"_158":208,"_159":137,"_160":136,"_161":162,"_105":271,"_100":32,"_164":182,"_166":272,"_167":22,"_168":-5,"_169":471,"_98":472},[],[207,269],[207],{"_103":277,"_95":278,"_156":279,"_158":-5,"_159":137,"_160":136,"_161":162,"_105":280,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":475,"_98":485},[476,479,482],{"_103":283,"_95":284,"_156":285,"_158":279,"_159":137,"_160":136,"_161":162,"_105":286,"_100":32,"_164":182,"_166":287,"_167":22,"_168":-5,"_169":477,"_98":478},[],[278,284],{"_103":291,"_95":292,"_156":293,"_158":279,"_159":137,"_160":136,"_161":162,"_105":294,"_100":32,"_164":182,"_166":295,"_167":22,"_168":-5,"_169":480,"_98":481},[],[278,292],{"_103":299,"_95":300,"_156":301,"_158":279,"_159":137,"_160":136,"_161":162,"_105":302,"_100":32,"_164":182,"_166":303,"_167":22,"_168":-5,"_169":483,"_98":484},[],[278,300],[278],{"_103":308,"_95":309,"_156":310,"_158":-5,"_159":137,"_160":136,"_161":162,"_105":311,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_169":487,"_98":497},[488,491,494],{"_103":314,"_95":315,"_156":316,"_158":310,"_159":137,"_160":136,"_161":162,"_105":317,"_100":32,"_164":182,"_166":318,"_167":22,"_168":-5,"_169":489,"_98":490},[],[309,315],{"_103":322,"_95":323,"_156":324,"_158":310,"_159":137,"_160":136,"_161":162,"_105":325,"_100":32,"_164":182,"_166":326,"_167":22,"_168":-5,"_169":492,"_98":493},[],[309,323],{"_103":330,"_95":331,"_156":332,"_158":310,"_159":137,"_160":136,"_161":162,"_105":333,"_100":32,"_164":182,"_166":334,"_167":22,"_168":-5,"_169":495,"_98":496},[],[309,331],[309],{"_103":339,"_95":340,"_156":341,"_158":-5,"_159":137,"_160":136,"_161":162,"_105":342,"_100":32,"_164":263,"_166":343,"_167":22,"_168":-5,"_169":499,"_98":500},[],[340],{"_103":347,"_95":348,"_156":349,"_158":-5,"_159":137,"_160":136,"_161":162,"_105":350,"_100":32,"_164":263,"_166":351,"_167":22,"_168":-5,"_169":502,"_98":503},[],[348],{"_103":355,"_95":356,"_156":357,"_158":-5,"_159":137,"_160":136,"_161":162,"_105":358,"_100":32,"_164":263,"_166":359,"_167":22,"_168":-5,"_169":505,"_98":506},[],[356],{"_103":363,"_95":364,"_156":365,"_158":-5,"_159":137,"_160":136,"_161":162,"_105":366,"_100":32,"_164":263,"_166":367,"_167":22,"_168":-5,"_169":508,"_98":509},[],[364],{"_103":371,"_95":372,"_156":373,"_158":-5,"_159":137,"_160":136,"_161":162,"_105":374,"_100":32,"_164":263,"_166":375,"_167":22,"_168":-5,"_169":511,"_98":512},[],[372],{"_103":379,"_95":380,"_156":381,"_158":-5,"_159":137,"_160":136,"_161":162,"_105":382,"_100":32,"_164":263,"_166":383,"_167":22,"_168":-5,"_169":514,"_98":515},[],[380],[432,434,436,439,443,447,449,451,454,457,460,463,467,470,474,476,479,482,486,488,491,494,498,501,504,507,510,513],{"_103":172,"_95":173,"_156":174,"_158":157,"_159":137,"_160":136,"_161":162,"_105":403,"_100":32,"_164":165,"_166":-5,"_167":22,"_168":-5,"_98":518},[155,173],[520,522],{"_103":178,"_95":179,"_156":180,"_158":174,"_159":137,"_160":136,"_161":162,"_105":397,"_100":32,"_164":182,"_166":183,"_167":22,"_168":-5,"_98":521},[155,173,179],{"_103":187,"_95":188,"_156":189,"_158":174,"_159":137,"_160":136,"_161":162,"_105":400,"_100":32,"_164":182,"_166":191,"_167":22,"_168":-5,"_98":523},[155,173,188],"upstream",{"_103":140,"_105":526,"_413":527,"_95":43,"_138":145,"_100":415,"_139":416,"_141":417,"_418":419,"_107":-5,"_150":22,"_109":110,"_149":408,"_16":147,"_148":96},["D",1752538385443],["D",1755531530908],"showCompareCallout","pull","ahead","behind",72,"templates",[535,552],{"_103":536,"_95":537,"_105":538,"_107":-5,"_108":22,"_109":110,"_111":539,"_112":540,"_14":541,"_114":542,"_115":162,"_116":543,"_117":544,"_16":545,"_119":120,"_121":120,"_122":123,"_124":123,"_125":123,"_126":120,"_127":120,"_23":546,"_131":549,"_134":550,"_150":22},"8e7382ae-d835-11ef-bbbf-e6cdfca9ef9f","markdownBlogStarter",["D",1737491000655],"Starter template for a markdown blog","https://imagedelivery.net/iHX6Ovru0O7AjmyT5yZRoA/44a31e5c-3e8a-48a8-d067-5785c0b08200/square512","a0bf3b31-15a5-4d5c-880e-4b1e22c9bc18","a4a9ad14-d835-11ef-8351-e6cdfca9ef9f",167,11,"e81e7335-6d4c-4764-a902-d0962bbfa9f7",{"_93":547,"_129":548},"stevekrouse","https://images.clerk.dev/uploaded/img_2PqHa2Gsy93xQrjh2w78Xu0cChW.jpeg",{"_93":547,"_133":548},{"_103":551,"_95":43,"_100":543,"_138":536,"_139":-5,"_141":-5},"8e73c264-d835-11ef-bbbf-e6cdfca9ef9f",{"_103":553,"_95":554,"_105":555,"_107":-5,"_108":22,"_109":110,"_111":556,"_112":-5,"_14":557,"_114":558,"_115":162,"_116":559,"_117":560,"_16":561,"_119":120,"_121":120,"_122":123,"_124":123,"_125":123,"_126":120,"_127":120,"_23":562,"_131":565,"_134":566,"_150":22},"96102714-f528-11ef-aa68-569c3dd06744","reactHonoStarter",["D",1740674013689],"Starter template with client-side React & Hono server","c9143560-63b6-444f-8f9f-e2647fabe09f","a9b2b20a-f528-11ef-9e98-569c3dd06744",39,14,"c606f87f-4d7e-48c8-9c39-ef5ab94aec49",{"_93":563,"_129":564},"std","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvdXBsb2FkZWQvaW1nXzJVaVhpQ1BId3dscVpBbkdZVWlMNjJtcjkxWS5wbmcifQ",{"_93":563,"_133":564},{"_103":567,"_95":43,"_100":532,"_138":553,"_139":-5,"_141":-5},"961078ea-f528-11ef-aa68-569c3dd06744","actionData","errors"]

charmaine

custom-endpoints