Adds the prerendering requirements, design and baseline

Records the requirements, execution plan, application design, the first unit's
functional design and code generation plan, and the baseline on master.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-31 17:41:12 +01:00
co-authored by Claude Opus 5.5
parent c4c2f83d6c
commit 65c850e949
22 changed files with 2569 additions and 0 deletions
@@ -0,0 +1,67 @@
# Component Dependencies: prerendering
```mermaid
graph TD
Vite["vite.config.ts"]
Router["src/router.tsx"]
Root["routes/__root.tsx"]
Client["src/client.tsx"]
Routes["Page routes and catch-all route"]
Hydrated["useHydrated and server-safe hooks"]
Display["Reveal, DeferredImage, NoScriptNav"]
Extract["config/externalizeInlineScripts.ts"]
Logic["config/inlineScripts.ts"]
Output["dist/client"]
Preview["config/previewServer.ts"]
Headers["config/securityHeaders.ts"]
ServerConfig["config/serverConfig.ts"]
E2E["e2e browser tests and Lighthouse"]
Vite --> Router
Router --> Root
Client --> Router
Root --> Routes
Routes --> Hydrated
Routes --> Display
Display --> Hydrated
Vite --> Output
Extract --> Logic
Extract --> Output
Preview --> Output
Preview --> Headers
ServerConfig --> Headers
E2E --> Preview
classDef build fill:#63b3ed,stroke:#2b6cb0,stroke-width:1px,color:#000;
classDef app fill:#9ae6b4,stroke:#2f855a,stroke-width:1px,color:#000;
classDef infra fill:#fbd38d,stroke:#92400e,stroke-width:1px,color:#000;
classDef check fill:#f6e05e,stroke:#c05621,stroke-width:1px,color:#000;
class Vite,Extract,Logic,Output build;
class Router,Root,Client,Routes,Hydrated,Display app;
class Preview,Headers,ServerConfig infra;
class E2E check;
```
Text alternative: the Vite config drives the router, root route and pages, which use hydration-safe hooks and display components; the post-build step rewrites the client output; the preview server serves that output with the shared headers for the browser tests and Lighthouse.
## Dependency matrix
| Component | Depends on | Used by | Communication |
|---|---|---|---|
| `tanstackStart` plugin | `src/router.tsx`, route tree | Build | Build time |
| `__root.tsx` shell | `HeadContent`, `Scripts`, `ChakraProvider`, `theme.ts` | All pages | Render |
| `useHydrated` | React | `NotFound`, search-dependent routes, display components | Hook |
| `inlineScripts.ts` | None | Runner, tests | Pure function |
| `externalizeInlineScripts.ts` | `inlineScripts.ts`, file system | `pnpm build` | Build time |
| `previewServer.ts` | `securityHeaders.ts`, file system | Lighthouse, `e2e/` | HTTP |
| `serverConfig.ts` | `securityHeaders.ts` | `deploy/` | Generated files |
## Unit boundaries
| Unit | Owns |
|---|---|
| 1 | Build and entry, hydration safety, script step, preview server, browser tests, test setup, CI output path |
| 2 | `Reveal`, `DeferredImage`, `NoScriptNav`, no-JavaScript fallbacks, photo preload |
| 3 | `serverConfig.ts`, `deploy/`, CI upload order, Lighthouse targets |
Units run in sequence, so shared files are not a merge concern.