Skip to content

Rename Copy as prompt to Copy prompt, convert FixOption to FixCard#95309

Merged
aurorascharff merged 7 commits into
canaryfrom
codex/copy-prompt-fix-cards
Jul 1, 2026
Merged

Rename Copy as prompt to Copy prompt, convert FixOption to FixCard#95309
aurorascharff merged 7 commits into
canaryfrom
codex/copy-prompt-fix-cards

Conversation

@aurorascharff

@aurorascharff aurorascharff commented Jun 30, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Why

Standardize the Insight fix UI across the dev overlay and docs, and round out the docs side with a proper family index at the bottom of every page.

What

  • Dev overlay: Copy as prompt -> Copy prompt; bumped the pill padding to match the new docs button.
  • Error pages (errors/*.mdx, 15 files): <FixOption> -> <FixCardGrid>/<FixCard> with snippets copied verbatim from instant-guidance-data.ts; all https://preview.nextjs.org/docs/... URLs converted to relative /docs/....
  • Every Insight error page now ends with a ## Related Insights index listing the other 14 Insight pages (self omitted).
  • instant-navigation.mdx and migrating-to-cache-components.mdx: dropped the stray trailing } snippet line so guide cards match dev-overlay heights; added a one-line Copy prompt note linking to #ai-workflow.
  • insight-error-page skill: replaced the "Useful links" guidance with "Related Insights" (full family index, no API refs/guides) and matching audit-checklist line.
  • Minor cleanup in instant-guidance-data.ts (trimmed verbose JSDoc to non-obvious bits).

How

Paired with vercel/front#75443 which adds the Copy prompt button to <FixCard> and deletes the legacy <FixOption>. pnpm --filter=next types clean, 23 instant-guidance-data tests pass.
@github-actions

github-actions Bot commented Jun 30, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Stats cancelled

Commit: ae99b75
View workflow run
@github-actions

github-actions Bot commented Jun 30, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Tests Passed

Commit: ae99b75
@aurorascharff aurorascharff marked this pull request as ready for review June 30, 2026 13:15
Copilot AI review requested due to automatic review settings June 30, 2026 13:15
@aurorascharff aurorascharff requested a review from icyJoseph June 30, 2026 13:17
Copilot AI reviewed Jun 30, 2026
View reviewed changes

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.

Pull request overview

Standardizes the “Insight” fix-card UI across the dev overlay and docs by aligning on a single copy-button label (“Copy prompt”) and a single MDX component shape (FixCardGrid/FixCard) that matches the framework’s fix-card data model.

Changes:

  • Dev overlay: rename the copy action label from “Copy as prompt” to “Copy prompt”, and adjust associated button styling.
  • Docs + insight error pages: migrate from <FixOption> to <FixCardGrid>/<FixCard> and inline the framework snippet arrays for visual consistency.
  • Authoring guidance: update the insight-error-page skill to reflect the new component/label and require a full “Related Insights” index.

Reviewed changes

Copilot reviewed 20 out of 20 changed files in this pull request and generated 1 comment.

Show a summary per file
File Description
packages/next/src/next-devtools/dev-overlay/components/instant/instant-guidance.tsx Renames the copy action label and tweaks button layout styles.
packages/next/src/next-devtools/dev-overlay/components/instant/instant-guidance-data.ts Updates FixCard type docs/comments to match the new wording and snippet-part docs.
errors/instant-unrendered-segment.mdx Converts fix UI to FixCardGrid/FixCard, updates internal docs links, adds “Related Insights”.
errors/instant-link-prefetch-partial.mdx Converts fix UI to FixCardGrid/FixCard, updates internal docs links, adds “Related Insights”.
errors/blocking-prerender-viewport-runtime.mdx Converts fix UI to FixCardGrid/FixCard, updates internal docs links, adds “Related Insights”.
errors/blocking-prerender-viewport-dynamic.mdx Converts fix UI to FixCardGrid/FixCard, updates internal docs links, adds “Related Insights”.
errors/blocking-prerender-runtime.mdx Converts fix UI to FixCardGrid/FixCard, updates internal docs links, adds “Related Insights”.
errors/blocking-prerender-dynamic.mdx Converts fix UI to FixCardGrid/FixCard, updates internal docs links, adds “Related Insights”.
errors/blocking-prerender-random.mdx Converts fix UI to FixCardGrid/FixCard, updates internal docs links, adds “Related Insights”.
errors/blocking-prerender-random-client.mdx Converts fix UI to FixCardGrid/FixCard, updates internal docs links, adds “Related Insights”.
errors/blocking-prerender-current-time.mdx Converts fix UI to FixCardGrid/FixCard, updates internal docs links, adds “Related Insights”.
errors/blocking-prerender-current-time-client.mdx Converts fix UI to FixCardGrid/FixCard, updates internal docs links, adds “Related Insights”.
errors/blocking-prerender-crypto.mdx Converts fix UI to FixCardGrid/FixCard, updates internal docs links, adds “Related Insights”.
errors/blocking-prerender-crypto-client.mdx Converts fix UI to FixCardGrid/FixCard, updates internal docs links, adds “Related Insights”.
errors/blocking-prerender-client-hook.mdx Converts fix UI to FixCardGrid/FixCard, updates internal docs links, adds “Related Insights”.
docs/01-app/02-guides/migrating-to-cache-components.mdx Aligns example fix-card snippets with framework snippet shape.
docs/01-app/02-guides/instant-navigation.mdx Adds note about “Copy prompt” and aligns snippets with framework snippet shape.
.agents/skills/insight-error-page/SKILL.md Updates skill guidance for FixCard usage + label change (but checklist still mentions “Useful links”).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Comment thread .agents/skills/insight-error-page/SKILL.md Outdated
icyJoseph
icyJoseph reviewed Jul 1, 2026
View reviewed changes
Comment thread errors/blocking-prerender-crypto-client.mdx Outdated
@aurorascharff
docs(skill): fix stale Useful Links reference to Related Insights
b7e313b
@aurorascharff
docs(errors): keep io() links as preview URLs until io is on stable
168c159 
io() is not yet on stable, so relative /docs links to it 404 on
nextjs.org. Point the 12 io() links at preview.nextjs.org until it
ships; other API links stay relative.
icyJoseph
icyJoseph approved these changes Jul 1, 2026
View reviewed changes

@icyJoseph icyJoseph left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Approving though there might be some links that are still being fixed.
@aurorascharff
docs(errors): point 16.3-updated doc links to preview, keep old pages…
ae99b75 
… relative

The preview->relative conversion was too broad: links to pages that are
new or updated for 16.3 (instant, cacheComponents, use-cache, connection,
instant-navigation, glossary, streaming, etc.) 404 on stable nextjs.org
because those pages are missing or stale there. Point those at preview;
keep genuinely-unchanged-since-16.2 pages (Pages Router, image, css,
draft-mode, etc.) and all /docs/messages links relative.
@aurorascharff aurorascharff merged commit 6c5f3d5 into canary Jul 1, 2026
129 of 130 checks passed
@aurorascharff aurorascharff deleted the codex/copy-prompt-fix-cards branch July 1, 2026 14:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

3 participants

@aurorascharff @icyJoseph