{"record":{"id":"f17aedd98e97bea3","repo":"remix-run/react-router","slug":"spa-mode-did-you-forget-to-include-scripts-i","errorCode":null,"errorMessage":"SPA Mode: Did you forget to include `` in your root route? Your pre-rendered HTML cannot hydrate without ``.","messagePattern":"SPA Mode: Did you forget to include `` in your root route\\? Your pre-rendered HTML cannot hydrate without ``\\.","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"packages/react-router-dev/vite/plugin.ts","lineNumber":2616,"sourceCode":" }\n\n // Handle document responses (html or spa)\n let html = await response.text();\n\n if (metadata.type === \"spa\") {\n if (response.status !== 200) {\n throw new Error(\n `SPA Mode: Received a ${response.status} status code from ` +\n `\\`entry.server.tsx\\` while prerendering your SPA Fallback HTML file.\\n` +\n html,\n );\n }\n\n if (\n !html.includes(\"window.__reactRouterContext =\") ||\n !html.includes(\"window.__reactRouterRouteModules =\")\n ) {\n throw new Error(\n \"SPA Mode: Did you forget to include `` in your root route? \" +\n \"Your pre-rendered HTML cannot hydrate without ``.\",\n );\n }\n\n // SPA fallback is written to root regardless of basename\n return [\n {\n path: \"/__spa-fallback.html\",\n contents: html,\n },\n ];\n }\n\n // Handle html responses\n let pathname = new URL(request.url).pathname;\n\n if (redirectStatusCodes.has(response.status)) {","sourceCodeStart":2598,"sourceCodeEnd":2634,"githubUrl":"https://github.com/remix-run/react-router/blob/1fd704a7dabcbe3ae09d7387b460e6acaba30ec1/packages/react-router-dev/vite/plugin.ts#L2598-L2634","documentation":"Thrown in `postProcess` when `metadata.type === \"spa\"` and the status is 200 but the rendered HTML is missing the inline `` output. React Router detects SPA-readiness by checking for `window.__reactRouterContext =` and `window.__reactRouterRouteModules =` in the rendered HTML; their absence means `` (and therefore the bootstrap payload) is not in the root route, so the SPA cannot hydrate.","triggerScenarios":"Root route's `` document does not render ``; `` is conditionally rendered and skipped in the fallback render; a custom `entry.server.tsx` strips script tags; the root layout was edited to remove `` while experimenting.","commonSituations":"Customizing the root document and forgetting ``; copy-pasting an HTML template from a non-React-Router source; conditionally hiding `` based on env vars that evaluate differently at build time.","solutions":["Open the root route (`app/root.tsx`) and confirm `` is rendered inside `` (typically alongside ``, ``).","Ensure `` is unconditional in the document layout.","If using a custom `entry.server.tsx`, do not strip `