docs: add ensureStatic reference and validation guidance (#99355)
## Summary - document the `ensureStatic` route segment config for Next.js 16.4, including the `shell`, `prefetch`, and `navigation` levels, their prerequisites, and how requirements compose across pages, layouts, and parallel routes - add the validation experience for `ensureStatic = 'navigation'`, including direct Learn more links, route, metadata, and viewport guidance, cause-oriented fix cards, and build diagnostics - add focused coverage for route content, metadata, viewport, cache lifetimes, server promises, and dynamic parameters This PR documents the final public `ensureStatic` name. The framework export change lands separately. Short-lived cache failures use the normal runtime-data or uncached-data message selected by the existing validator. They do not have a separate cache-lifetime classifier. ## Design and capture review - Route: [runtime data](https://error-messages-overhaul-ibsl.labs.vercel.dev/scenario/125-ensure-static-cookies), [uncached data](https://error-messages-overhaul-ibsl.labs.vercel.dev/scenario/128-ensure-static-uncached), [connection](https://error-messages-overhaul-ibsl.labs.vercel.dev/scenario/129-ensure-static-connection) - Metadata: [runtime data](https://error-messages-overhaul-ibsl.labs.vercel.dev/scenario/130-ensure-static-metadata-runtime), [uncached data](https://error-messages-overhaul-ibsl.labs.vercel.dev/scenario/131-ensure-static-metadata-dynamic) - Viewport: [runtime data](https://error-messages-overhaul-ibsl.labs.vercel.dev/scenario/132-ensure-static-viewport-runtime), [uncached data](https://error-messages-overhaul-ibsl.labs.vercel.dev/scenario/133-ensure-static-viewport-dynamic) - Cache lifetimes: [short expire](https://error-messages-overhaul-ibsl.labs.vercel.dev/scenario/134-ensure-static-short-expire), [short stale](https://error-messages-overhaul-ibsl.labs.vercel.dev/scenario/135-ensure-static-short-stale), [`revalidate: 0`](https://error-messages-overhaul-ibsl.labs.vercel.dev/scenario/136-ensure-static-zero-revalidate) - Other validation: [`instant = false`](https://error-messages-overhaul-ibsl.labs.vercel.dev/scenario/137-ensure-static-instant-false), [Suspense](https://error-messages-overhaul-ibsl.labs.vercel.dev/scenario/138-ensure-static-suspense), [server promise](https://error-messages-overhaul-ibsl.labs.vercel.dev/scenario/139-ensure-static-client-promise), [missing parameters](https://error-messages-overhaul-ibsl.labs.vercel.dev/scenario/144-ensure-static-missing-params) ## Verification - `pnpm --filter=next build` - Development E2E: 27 tests and 19 snapshots passed - Production E2E: 27 tests and 20 snapshots passed - Focused overlay message and fix-card unit suites: 137 tests passed - Error-overhaul production build: 124 routes generated - Captured build output for 22 Ensure Static scenarios and dev overlays for all applicable insight cases - Prettier, ESLint, and `git diff --check` passed for the changed framework files - Documentation link validation passed <!-- NEXT_JS_LLM --> --------- Co-authored-by:Joseph Chamochumbi <joseph.chamochumbi@vercel.com>
Showing
This diff is collapsed.
This diff is collapsed.
This diff is collapsed.
Please
register
or
sign in
to comment