Static output
Verify every documentation route before deploying it as static assets.
pnpm build compiles content and renders each landing and documentation route
to a directory index.html. It also emits Markdown endpoints, localized search
indexes, assets, LLM files, and the sitemap.
Production checklist
Set
site.baseUrlto the canonical production origin.Keep
prerender: trueand disable SPA fallback at the host.Verify a nested route with JavaScript disabled.
Request the same route with
Accept: text/markdown.Check canonical, Open Graph, and
hreflangtags in generated HTML.
Preview the exact dist directory with pnpm preview; do not use the development
server as deployment verification.
Route audit
Inspect the sitemap and compare it with generated HTML directories. Request a representative root page, nested page, localized fallback page, Markdown route, and unknown route.
Cache policy
Cache content-hashed assets immutably. Give HTML, Markdown, search, and LLM files a policy that lets new deployments replace them promptly.
Last updated 2 ago 2026