Skip to content

Add Errors/Insights tab split to the instant error overlay#94073

Open
aurorascharff wants to merge 10 commits into
canaryfrom
aurorascharff/instant-insights-tab
Open

Add Errors/Insights tab split to the instant error overlay#94073
aurorascharff wants to merge 10 commits into
canaryfrom
aurorascharff/instant-insights-tab

Conversation

@aurorascharff
Copy link
Copy Markdown
Contributor

@aurorascharff aurorascharff commented May 23, 2026

What?

Adds a tab bar to the dev overlay that separates normal errors ("Errors") from instant navigation errors ("Insights"). The indicator pill also reflects the split.

Why?

When unstable_instant validation produces navigation-phase errors alongside regular prerender errors, they were mixed into a single list. Developers had no way to tell which errors were structural instant-validation issues versus regular runtime/prerender errors.

Demo

How?

  • Errors splits runtimeErrors into normalErrors / instantErrors (using the existing inNavigation flag from getBlockingRouteErrorDetails) and defaults to whichever bucket has errors.
  • ErrorTabBar renders between the nav and dialog inside ErrorOverlayLayout (new tabBar prop). Empty tabs are disabled.
  • ErrorOverlay passes a key derived from the error composition so tab state resets when the shape changes (e.g. normal errors resolve).
  • RenderErrorContext gains instantErrorCount; the indicator pill shows "N Issues", "N Insights", or "N Issues · N Insights" accordingly.
  • Prerender errors show Blocking Route badge (red), navigation errors show Instant badge (amber).

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 23, 2026

Failing test suites

Commit: 57a9772 | About building and testing Next.js

pnpm test-start test/e2e/filesystem-cache/filesystem-cache.test.ts (job)

  • filesystem-caching with cache enabled > should allow to change files while stopped (RSC change, RCC change, Pages change, rename app page, next config change, env var change) (DD)
Expand output

● filesystem-caching with cache enabled › should allow to change files while stopped (RSC change, RCC change, Pages change, rename app page, next config change, env var change)

next build failed with code/signal 139

   99 |             if (code || signal)
  100 |               reject(
> 101 |                 new Error(
      |                 ^
  102 |                   `next build failed with code/signal ${code || signal}`
  103 |                 )
  104 |               )

  at ChildProcess.<anonymous> (lib/next-modes/next-start.ts:101:17)

@aurorascharff aurorascharff marked this pull request as ready for review May 25, 2026 14:06
Copilot AI review requested due to automatic review settings May 25, 2026 14:06
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds a tabbed "Errors" vs "Insights" split to the dev overlay, distinguishing navigation-phase unstable_instant validation errors from regular prerender/runtime errors. Navigation-phase blocking-route errors keep the amber Instant badge; all other prerender/metadata/viewport/sync-IO errors are relabeled Blocking Route. The indicator pill now reflects the same split ("Issues" / "Insights" / "Issues · Insights").

Changes:

  • New ErrorTabBar + isInstantNavigationError helper in container/errors.tsx, splitting runtimeErrors into normalErrors / instantErrors and scoping pagination to the active tab via a new tabBar prop on ErrorOverlayLayout.
  • RenderErrorContext and RenderRuntimeError expose a new instantErrorCount; next-logo.tsx uses it to drive the new pill label, data-insights-only state, and amber styling.
  • Test snapshots across cache-components/instant-validation suites updated from Instant to Blocking Route for prerender-phase errors; navigation-phase cases retain Instant.

Reviewed changes

Copilot reviewed 17 out of 17 changed files in this pull request and generated 4 comments.

Show a summary per file
File Description
packages/next/src/next-devtools/dev-overlay/container/errors.tsx Adds isInstantNavigationError, ErrorTabBar, tab state, label remapping, and tab-bar CSS.
packages/next/src/next-devtools/dev-overlay/container/errors.test.ts Tests for the new isInstantNavigationError helper.
packages/next/src/next-devtools/dev-overlay/container/runtime-error/render-error.tsx Exposes instantErrorCount derived from ready runtime errors.
packages/next/src/next-devtools/dev-overlay/dev-overlay.tsx Wires instantErrorCount through RenderErrorContext.
packages/next/src/next-devtools/dev-overlay/components/errors/error-overlay/error-overlay.tsx Adds composition-based key to reset tab state when bucket presence changes.
packages/next/src/next-devtools/dev-overlay/components/errors/error-overlay-layout/error-overlay-layout.tsx Adds optional tabBar slot between nav and dialog.
packages/next/src/next-devtools/dev-overlay/components/errors/error-type-label/error-type-label.tsx Drops the blocking-page class for Blocking Route and removes redundant font rules from instant.
packages/next/src/next-devtools/dev-overlay/components/errors/error-message/error-message.tsx Extends no-truncate/instant styling to Blocking Route messages.
packages/next/src/next-devtools/dev-overlay/components/dialog/dialog.tsx Excludes new tab bar from click-outside dismissal.
packages/next/src/next-devtools/dev-overlay/components/devtools-indicator/next-logo.tsx New PillLabel/Plural helpers, insights-only amber styling, mixed-count label.
packages/next/.storybook/decorators/with-dev-overlay-contexts.tsx Provides default instantErrorCount: 0 for stories.
test/development/app-dir/cache-components-dev-errors/…, test/development/app-dir/cache-components-dev-fallback-validation/…, test/e2e/app-dir/cache-components-errors/…, test/e2e/app-dir/instant-validation/…, test/e2e/app-dir/instant-validation-level-manual-warning/…, test/e2e/app-dir/instant-validation-static-shells/… Update redbox label expectations from Instant to Blocking Route for prerender-phase cases.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread packages/next/src/next-devtools/dev-overlay/container/errors.tsx Outdated
Comment thread packages/next/src/next-devtools/dev-overlay/container/errors.tsx
Comment thread packages/next/.storybook/decorators/with-dev-overlay-contexts.tsx Outdated
@github-actions
Copy link
Copy Markdown
Contributor

Stats from current PR

✅ No significant changes detected

📊 All Metrics
📖 Metrics Glossary

Dev Server Metrics:

  • Listen = TCP port starts accepting connections
  • First Request = HTTP server returns successful response
  • Cold = Fresh build (no cache)
  • Warm = With cached build artifacts

Build Metrics:

  • Fresh = Clean build (no .next directory)
  • Cached = With existing .next directory

Change Thresholds:

  • Time: Changes < 50ms AND < 10%, OR < 2% are insignificant
  • Size: Changes < 1KB AND < 1% are insignificant
  • All other changes are flagged to catch regressions

⚡ Dev Server

Metric Canary PR Change Trend
Cold (Listen) 811ms 811ms ▇▃▃▇▁
Cold (Ready in log) 788ms 790ms ▇▄▅█▂
Cold (First Request) 1.231s 1.229s ▆▃▃▇▁
Warm (Listen) 812ms 811ms ▃▁▁█▁
Warm (Ready in log) 789ms 791ms ▇▄▅█▃
Warm (First Request) 613ms 615ms █▆▇█▅
📦 Dev Server (Webpack) (Legacy)

📦 Dev Server (Webpack)

Metric Canary PR Change Trend
Cold (Listen) 811ms 811ms ████▁
Cold (Ready in log) 780ms 776ms ▇▇▇▇▁
Cold (First Request) 3.146s 3.151s ▃▃▂▃▂
Warm (Listen) 812ms 811ms ▄▄▄▄▁
Warm (Ready in log) 776ms 776ms ▄▃▄▄▁
Warm (First Request) 3.141s 3.143s ▁▁▁▁▁

⚡ Production Builds

Metric Canary PR Change Trend
Fresh Build 4.786s 4.751s ▇▃▃▃▁
Cached Build 4.788s 4.753s █▅▃▂▁
📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric Canary PR Change Trend
Fresh Build 23.758s 23.762s ▁▁▁▁▁
Cached Build 23.924s 23.987s ▁▁▁▁▁
node_modules Size 507 MB 507 MB ▄▄▄██
📦 Bundle Sizes

Bundle Sizes

⚡ Turbopack

Client

Main Bundles
Canary PR Change
04hm05ar7kldw.js gzip 5.73 kB N/A -
098ka_u220tdk.js gzip 156 B N/A -
0cz1d0mv5g_q7.js gzip 39.4 kB 39.4 kB
0dj46kukqg96u.js gzip 13.9 kB N/A -
0dvitrl5zg37g.js gzip 8.82 kB N/A -
0sf7ysou-72zd.js gzip 8.71 kB N/A -
0zs-b19qqd59_.js gzip 155 B N/A -
157abun3hwc_s.js gzip 10.3 kB N/A -
1bxqtqcf3f8yr.js gzip 156 B N/A -
1elt1qium-r2m.css gzip 115 B 115 B
1golzs3t44vj-.js gzip 160 B N/A -
1jpaub6y8xlfr.js gzip 2.3 kB N/A -
1ot0mvscrc_uf.js gzip 233 B N/A -
1rnm6t2_e33mw.js gzip 152 B N/A -
1sn6j350hah8s.js gzip 155 B N/A -
2_m3xv2uq3sjc.js gzip 1.46 kB N/A -
24y34mwgrkqp4.js gzip 8.78 kB N/A -
28auqfz251jql.js gzip 156 B N/A -
29z3aanknpw56.js gzip 50.5 kB N/A -
2c-fd4y1zozz8.js gzip 8.79 kB N/A -
2d7416h_xd36x.js gzip 8.71 kB N/A -
2g21ny1t2kw37.js gzip 7.61 kB N/A -
2k8v1ry9v-tjp.js gzip 65.6 kB N/A -
2lyuhit6rn8fy.js gzip 9.44 kB N/A -
2q0gr8wfr3jwl.js gzip 8.77 kB N/A -
2t9e75oz6r0zp.js gzip 8.76 kB N/A -
2uku_olcn15b7.js gzip 8.79 kB N/A -
2y4f1uh280a7j.js gzip 154 B N/A -
30r8mm-46bdqy.js gzip 220 B 220 B
353aci-f_3okg.js gzip 158 B N/A -
3a2sm44-0_ixu.js gzip 70.9 kB N/A -
3b-ck6nis9_cd.js gzip 157 B N/A -
3bx-cg8jh2fsr.js gzip 160 B N/A -
3c1jdxkzlb8oq.js gzip 12.9 kB N/A -
3gq9tasot1hwc.js gzip 154 B N/A -
3inab2jybr4k9.js gzip 450 B N/A -
3jkm5tdjvaf_q.js gzip 13.1 kB N/A -
3mt67agm5wp40.js gzip 10.6 kB N/A -
3saabek4kohwi.js gzip 10 kB N/A -
3x7n3psq969c3.js gzip 168 B N/A -
4189xmby9yu1p.js gzip 13.6 kB N/A -
turbopack-09..bv0o.js gzip 4.18 kB N/A -
turbopack-0d..x5sr.js gzip 4.2 kB N/A -
turbopack-1f..-8cu.js gzip 4.2 kB N/A -
turbopack-1m..nanf.js gzip 4.2 kB N/A -
turbopack-1r..r-go.js gzip 4.2 kB N/A -
turbopack-1r..c8xm.js gzip 4.2 kB N/A -
turbopack-2a..l-bl.js gzip 4.2 kB N/A -
turbopack-2b..rbkb.js gzip 4.2 kB N/A -
turbopack-2r.._ijx.js gzip 4.2 kB N/A -
turbopack-2r..i-df.js gzip 4.21 kB N/A -
turbopack-3b..ywg1.js gzip 4.2 kB N/A -
turbopack-3p..mjhr.js gzip 4.2 kB N/A -
turbopack-3v..j2ck.js gzip 4.2 kB N/A -
turbopack-40..f2gf.js gzip 4.2 kB N/A -
0_i7nqgx23st7.js gzip N/A 10 kB -
06puhytyxk31p.js gzip N/A 8.82 kB -
08nk339p9gvvz.js gzip N/A 157 B -
0f50yxs5dv2yk.js gzip N/A 70.9 kB -
0j_9aszpra-qr.js gzip N/A 13.9 kB -
0j42f9zonj0wd.js gzip N/A 13 kB -
0m34gln_kt4fg.js gzip N/A 5.73 kB -
0wlbdlk4_e4do.js gzip N/A 170 B -
15m8j3l4c3oy7.js gzip N/A 158 B -
1d638jq2r-pw8.js gzip N/A 155 B -
1g3q1ww01thnl.js gzip N/A 2.3 kB -
1hpx0u0fjqzuk.js gzip N/A 155 B -
1hraqxuiymq6v.js gzip N/A 8.79 kB -
1l9un1sl77287.js gzip N/A 1.46 kB -
1q5pzsmugt1sw.js gzip N/A 152 B -
2147zgtf14z-q.js gzip N/A 234 B -
23bz3xsg-5-1s.js gzip N/A 8.71 kB -
27441mytv7pbm.js gzip N/A 9.43 kB -
2cjkwjgm1zcfs.js gzip N/A 8.71 kB -
2cnvy9tswyud3.js gzip N/A 158 B -
2kqe5mpuqaajh.js gzip N/A 162 B -
2scd8zaoyb8md.js gzip N/A 8.79 kB -
2st_qs6p_9us0.js gzip N/A 13.1 kB -
2zo2exm1d8qj1.js gzip N/A 13.6 kB -
31i2t3cfybt1e.js gzip N/A 158 B -
32z0g980vfa1y.js gzip N/A 156 B -
34bczktl9n3gx.js gzip N/A 156 B -
34vcsc6938ixq.js gzip N/A 50.5 kB -
38npdmive1xa6.js gzip N/A 65.6 kB -
3f710q6kll2xn.js gzip N/A 7.61 kB -
3hn75zuxly9az.js gzip N/A 10.3 kB -
3hqh7m128tvsn.js gzip N/A 8.77 kB -
3hqti_t-zy1x4.js gzip N/A 449 B -
3jj3ls-hi6740.js gzip N/A 156 B -
3mnawenie1flm.js gzip N/A 8.76 kB -
3ubsozlu6zs38.js gzip N/A 10.6 kB -
4371ttxpn0nn6.js gzip N/A 160 B -
43iwfqjnx1cy_.js gzip N/A 8.78 kB -
turbopack-0f..2xc-.js gzip N/A 4.2 kB -
turbopack-0x..rwp8.js gzip N/A 4.2 kB -
turbopack-0y..np0p.js gzip N/A 4.2 kB -
turbopack-0z..gytn.js gzip N/A 4.2 kB -
turbopack-1m..bjhk.js gzip N/A 4.2 kB -
turbopack-1s..s0ff.js gzip N/A 4.2 kB -
turbopack-2d..w2zz.js gzip N/A 4.18 kB -
turbopack-30..qx63.js gzip N/A 4.2 kB -
turbopack-3l..h25l.js gzip N/A 4.2 kB -
turbopack-3m..zp1q.js gzip N/A 4.2 kB -
turbopack-3p..1_v2.js gzip N/A 4.2 kB -
turbopack-3u..v5xe.js gzip N/A 4.2 kB -
turbopack-3u..ro77.js gzip N/A 4.2 kB -
turbopack-43..ze1i.js gzip N/A 4.21 kB -
Total 469 kB 469 kB ⚠️ +65 B

Server

Middleware
Canary PR Change
middleware-b..fest.js gzip 720 B 722 B
Total 720 B 722 B ⚠️ +2 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 432 B 435 B
Total 432 B 435 B ⚠️ +3 B

📦 Webpack

Client

Main Bundles
Canary PR Change
2258-HASH.js gzip 61.5 kB N/A -
2266-HASH.js gzip 4.69 kB N/A -
3317.HASH.js gzip 169 B N/A -
4866-HASH.js gzip 5.64 kB N/A -
9e302639-HASH.js gzip 62.8 kB N/A -
framework-HASH.js gzip 59.5 kB 59.5 kB
main-app-HASH.js gzip 255 B 254 B
main-HASH.js gzip 39.9 kB 39.9 kB
webpack-HASH.js gzip 1.68 kB 1.68 kB
175fd0fd-HASH.js gzip N/A 62.8 kB -
2596-HASH.js gzip N/A 5.63 kB -
34-HASH.js gzip N/A 61.4 kB -
5691.HASH.js gzip N/A 169 B -
9156-HASH.js gzip N/A 4.68 kB -
Total 236 kB 236 kB ✅ -129 B
Polyfills
Canary PR Change
polyfills-HASH.js gzip 39.4 kB 39.4 kB
Total 39.4 kB 39.4 kB
Pages
Canary PR Change
_app-HASH.js gzip 193 B 193 B
_error-HASH.js gzip 181 B 182 B
css-HASH.js gzip 334 B 332 B
dynamic-HASH.js gzip 1.79 kB 1.81 kB
edge-ssr-HASH.js gzip 255 B 255 B
head-HASH.js gzip 351 B 348 B
hooks-HASH.js gzip 385 B 384 B
image-HASH.js gzip 580 B 580 B
index-HASH.js gzip 257 B 259 B
link-HASH.js gzip 2.51 kB 2.52 kB
routerDirect..HASH.js gzip 318 B 319 B
script-HASH.js gzip 387 B 386 B
withRouter-HASH.js gzip 316 B 316 B
1afbb74e6ecf..834.css gzip 106 B 106 B
Total 7.97 kB 7.99 kB ⚠️ +19 B

Server

Edge SSR
Canary PR Change
edge-ssr.js gzip 126 kB 126 kB
page.js gzip 277 kB 271 kB 🟢 5.31 kB (-2%)
Total 403 kB 397 kB ✅ -5.52 kB
Middleware
Canary PR Change
middleware-b..fest.js gzip 620 B 616 B
middleware-r..fest.js gzip 155 B 155 B
middleware.js gzip 44.3 kB 44.5 kB
edge-runtime..pack.js gzip 842 B 842 B
Total 45.9 kB 46.1 kB ⚠️ +240 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 719 B 717 B
Total 719 B 717 B ✅ -2 B
Build Cache
Canary PR Change
0.pack gzip 4.49 MB 4.49 MB
index.pack gzip 114 kB 114 kB
index.pack.old gzip 116 kB 116 kB
Total 4.72 MB 4.72 MB ✅ -722 B

🔄 Shared (bundler-independent)

Runtimes
Canary PR Change
app-page-exp...dev.js gzip 351 kB 351 kB
app-page-exp..prod.js gzip 195 kB 195 kB
app-page-tur...dev.js gzip 350 kB 350 kB
app-page-tur..prod.js gzip 194 kB 194 kB
app-page-tur...dev.js gzip 347 kB 347 kB
app-page-tur..prod.js gzip 192 kB 192 kB
app-page.run...dev.js gzip 347 kB 347 kB
app-page.run..prod.js gzip 193 kB 193 kB
app-route-ex...dev.js gzip 77.6 kB 77.6 kB
app-route-ex..prod.js gzip 52.9 kB 52.9 kB
app-route-tu...dev.js gzip 77.6 kB 77.6 kB
app-route-tu..prod.js gzip 52.9 kB 52.9 kB
app-route-tu...dev.js gzip 77.2 kB 77.2 kB
app-route-tu..prod.js gzip 52.7 kB 52.7 kB
app-route.ru...dev.js gzip 77.2 kB 77.2 kB
app-route.ru..prod.js gzip 52.7 kB 52.7 kB
dist_client_...dev.js gzip 324 B 324 B
dist_client_...dev.js gzip 326 B 326 B
dist_client_...dev.js gzip 318 B 318 B
dist_client_...dev.js gzip 317 B 317 B
pages-api-tu...dev.js gzip 44.3 kB 44.3 kB
pages-api-tu..prod.js gzip 33.8 kB 33.8 kB
pages-api.ru...dev.js gzip 44.3 kB 44.3 kB
pages-api.ru..prod.js gzip 33.7 kB 33.7 kB
pages-turbo....dev.js gzip 53.7 kB 53.7 kB
pages-turbo...prod.js gzip 39.4 kB 39.4 kB
pages.runtim...dev.js gzip 53.6 kB 53.6 kB
pages.runtim..prod.js gzip 39.4 kB 39.4 kB
server.runti..prod.js gzip 63.1 kB 63.1 kB
use-cache-pr...dev.js gzip 69.7 kB 69.7 kB
use-cache-pr...dev.js gzip 69.7 kB 69.7 kB
use-cache-pr...dev.js gzip 68 kB 68 kB
use-cache-pr...dev.js gzip 68 kB 68 kB
Total 3.37 MB 3.37 MB ⚠️ +2 B
📝 Changed Files (2 files)

Files with changes:

  • pages-api-tu..ntime.dev.js
  • pages-turbo...ntime.dev.js
View diffs
pages-api-tu..ntime.dev.js

Diff too large to display

pages-turbo...ntime.dev.js

Diff too large to display

📎 Tarball URL
https://vercel-packages.vercel.app/next/commits/57a9772b38d6e34b3b31a283ccddd3e2497a86ab/next

Commit: 57a9772

@aurorascharff aurorascharff requested a review from samselikoff May 25, 2026 20:43
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.

2 participants