Visitar URL original
Improve static route error guidance by aurorascharff · Pull Request #99724 · vercel/next.js · GitHub
Skip to content

Improve static route error guidance - #99724

Merged
aurorascharff merged 7 commits into
canaryfrom
codex/static-route-error-copy
Oct 6, 2026
Merged

aurorascharff merged 7 commits into
canaryfrom
codex/static-route-error-copy

Conversation

@aurorascharff

@aurorascharff aurorascharff commented Oct 6, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • explain that request-time work conflicts with the route's static requirement without repeating “fully static”
  • align the overlay explanations, build messages, and error pages for route body, generateMetadata(), and generateViewport() errors
  • replace the cookie-specific runtime-data card with short browser-data pseudocode while preserving its existing docs anchor
  • update the affected build-output snapshots

Verification

  • pnpm jest packages/next/src/next-devtools/dev-overlay/components/instant/instant-guidance-data.test.ts
  • formatted and linted all changed source, test, and MDX files
  • Not run: full package build (the isolated worktree reused an older dependency install that does not include the latest @base-ui-components/react packages)

@github-actions

github-actions Bot commented Oct 6, 2026 •

Copy link
Copy Markdown
Contributor

Tests Passed

Commit: 2ca482f

@aurorascharff
aurorascharff marked this pull request as ready for review October 6, 2026 11:01
Copilot AI balanced review requested due to automatic review settings October 6, 2026 11:01

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

Six rewritten factory-message variants lack direct text assertions despite messaging alignment being the PR’s primary behavior.

Review effort: Balanced
Findings: 1 Low severity

Open (1)
What changed in this PR

Aligns static-route error guidance across server messages, overlays, documentation, and snapshots.

Changes:

  • Reframes conflicts as request-time work versus static requirements.
  • Generalizes client-side browser-data guidance.
  • Updates related tests and snapshots.
File Description
test/​e2e/​app-dir/​instant-validation/​head-and-reporting.util.ts Updates expected guidance.
test/​e2e/​app-dir/​ensure-static-navigation/​ensure-static-navigation.test.ts Updates build-error snapshots.
packages/​next/​src/​server/​app-render/​blocking-route-messages.ts Revises static-route error messages.
packages/​next/​src/​next-devtools/​dev-overlay/​components/​instant/​instant-guidance-data.ts Aligns overlay explanations and browser-data card.
packages/​next/​src/​next-devtools/​dev-overlay/​components/​instant/​instant-guidance-data.test.ts Tests revised overlay explanations.
errors/​static-viewport-runtime.mdx Updates runtime viewport guidance.
errors/​static-viewport-dynamic.mdx Updates dynamic viewport guidance.
errors/​static-route-runtime.mdx Updates runtime route guidance and card.
errors/​static-route-dynamic.mdx Updates dynamic route guidance.
errors/​static-metadata-runtime.mdx Updates runtime metadata guidance.
errors/​static-metadata-dynamic.mdx Updates dynamic metadata guidance.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@aurorascharff
aurorascharff enabled auto-merge (squash) October 6, 2026 13:52
@aurorascharff
aurorascharff merged commit b8c7c7f into canary Oct 6, 2026
320 of 325 checks passed
@aurorascharff
aurorascharff deleted the codex/static-route-error-copy branch October 6, 2026 14:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants