Skip to content

[PPF] Scaffold navigation() - #97236

Open
lubieowoce wants to merge 1 commit into
canaryfrom
lubieowoce/scaffold-navigation
Open

[PPF] Scaffold navigation()#97236
lubieowoce wants to merge 1 commit into
canaryfrom
lubieowoce/scaffold-navigation

Conversation

@lubieowoce

@lubieowoce lubieowoce commented Aug 12, 2026 •
edited
Loading

Copy link
Copy Markdown
Member

Scaffolds a new API, unstable_navigation(). It's only allowed in server code, so we ban it from being imported in the client.
Implementation follows upstack. Intended to be merged together.

@github-actions

github-actions Bot commented Aug 12, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Stats from current PR

🟢 1 improvement

Metric Canary PR Change Trend
Webpack Build Time 25.248s 24.456s 🟢 792ms (-3%) ▁▁█▁█
📊 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) 813ms 812ms ✓ ▂▂▂▁▇
Cold (Ready in log) 772ms 790ms ✓ ▁▁▁▁█
Cold (First Request) 1.291s 1.309s ✓ ▁▁▁▁█
Warm (Listen) 812ms 812ms ✓ ▁▁▁▁▇
Warm (Ready in log) 779ms 789ms ✓ ▁▁▁▁█
Warm (First Request) 1.266s 1.285s ✓ ▄▄▅▄█
📦 Dev Server (Webpack) (Legacy)

📦 Dev Server (Webpack)

Metric Canary PR Change Trend
Cold (Listen) 813ms 813ms ✓ ▂▂█▁█
Cold (Ready in log) 794ms 792ms ✓ ▁▁█▁█
Cold (First Request) 3.383s 3.424s ✓ ▂▂▇▁█
Warm (Listen) 813ms 812ms ✓ ▂▂█▁█
Warm (Ready in log) 799ms 779ms ✓ ▁▁█▁█
Warm (First Request) 3.481s 3.397s ✓ ▂▁▇▁█

⚡ Production Builds

Metric Canary PR Change Trend
Fresh Build 5.738s 5.823s ✓ ▁▁▂▁▇
Cached Build 2.933s 3.038s ✓ ▁▁▂▁█
📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric Canary PR Change Trend
Fresh Build 25.248s 24.456s 🟢 792ms (-3%) ▁▁█▁█
Cached Build 25.114s 25.143s ✓ ▁▁█▁█
node_modules Size 554 MB 554 MB ✓ █████
📦 Bundle Sizes

Bundle Sizes

⚡ Turbopack

Client

Main Bundles
Canary PR Change
050icza-xjz0i.js gzip 5.73 kB N/A -
07jdby0ue616s.js gzip 450 B N/A -
07urkdg0dykcs.js gzip 65.6 kB N/A -
0bjdc8muo74n5.js gzip 8.71 kB N/A -
0cz1d0mv5g_q7.js gzip 39.4 kB 39.4 kB ✓
0rci1f3or1a19.js gzip 13.3 kB N/A -
0sxxfj-rbsawt.js gzip 156 B N/A -
0xojv0e93ooua.js gzip 46.6 kB N/A -
1_2x714--ii1i.js gzip 8.76 kB N/A -
1-3y752pkth5-.js gzip 10 kB N/A -
16m_1isl3yebg.js gzip 160 B N/A -
1elt1qium-r2m.css gzip 115 B 115 B ✓
1k6dd7su4cfei.js gzip 3.57 kB N/A -
1lavfv0i8nji9.js gzip 169 B N/A -
1o_2-tu_9n-52.js gzip 156 B N/A -
1sgudzpmz6kqb.js gzip 156 B N/A -
1tf1phijqlx9j.js gzip 220 B 220 B ✓
1tv9d53qjxrc4.js gzip 154 B N/A -
1uzabyd1120a1.js gzip 8.71 kB N/A -
2-ufv8lc-g7gg.js gzip 10.6 kB N/A -
20tj4y5ivq0i6.js gzip 71.5 kB N/A -
21kmjy_10x14f.js gzip 8.81 kB N/A -
28dhc6t85q1_p.js gzip 8.78 kB N/A -
2f-ilvczue-tp.js gzip 9.46 kB N/A -
2f1u17u5c8iny.js gzip 8.79 kB N/A -
2fklnf1x-tk68.js gzip 7.53 kB N/A -
2ikltg_8iegxw.js gzip 10.3 kB N/A -
2j2ttqi5g9blj.js gzip 155 B N/A -
2kui284uga7b6.js gzip 155 B N/A -
2uwdro9n-hon4.js gzip 155 B N/A -
2vxi673cz1-t4.js gzip 8.79 kB N/A -
2wl09dn_-n4bc.js gzip 155 B N/A -
2zsu_n81p41pd.js gzip 158 B N/A -
37_0a5zhxi3x0.js gzip 155 B N/A -
38-q43pzktqhs.js gzip 1.46 kB N/A -
3mrwxzed0ylgv.js gzip 13.1 kB N/A -
3nbojhxiy1qv_.js gzip 13.7 kB N/A -
3za005hicnoh6.js gzip 151 B N/A -
41u5s3oe2-erp.js gzip 2.29 kB N/A -
445s_9hf8o7ao.js gzip 8.76 kB N/A -
turbopack-0d..9ejy.js gzip 3.74 kB 3.74 kB ✓
0-6bcj16ji2wf.js gzip N/A 10.6 kB -
05d0jzkhr4rde.js gzip N/A 46.6 kB -
07ryk0jced-sc.js gzip N/A 8.78 kB -
0conq9-syukb3.js gzip N/A 155 B -
0jwho9fkrb_t3.js gzip N/A 2.29 kB -
0roh390ijzxa5.js gzip N/A 8.75 kB -
0s5p2i7xhghw7.js gzip N/A 156 B -
0vex9w55ursqj.js gzip N/A 8.79 kB -
17oe55cu76cd7.js gzip N/A 450 B -
1drww5xikb-c-.js gzip N/A 9.46 kB -
1g60xde_dv17t.js gzip N/A 8.79 kB -
1k_n61kh5ly4k.js gzip N/A 160 B -
1lemrogptjwhg.js gzip N/A 156 B -
1s59tx2uv_yer.js gzip N/A 65.6 kB -
1ubjv7x-14dtv.js gzip N/A 155 B -
1uzv47btzam64.js gzip N/A 5.73 kB -
1vy7n7wxv_rh5.js gzip N/A 8.81 kB -
2-0i7pl900-ou.js gzip N/A 8.71 kB -
2-kcbngm7ik7y.js gzip N/A 8.75 kB -
20fwfg_bnwgla.js gzip N/A 167 B -
22tfm-39cxdf0.js gzip N/A 155 B -
27y8rb0et-ncl.js gzip N/A 155 B -
29p5-xa4jmdhg.js gzip N/A 13.7 kB -
2jhbuzgq122u-.js gzip N/A 7.53 kB -
2lpk5_hknut8q.js gzip N/A 13.1 kB -
2o4cibp3awtbw.js gzip N/A 3.56 kB -
2ugc69z0t0ypz.js gzip N/A 1.46 kB -
2ux83go4-pltd.js gzip N/A 154 B -
2yjt57occm8et.js gzip N/A 155 B -
3-hqo3wvnsyne.js gzip N/A 71.5 kB -
33waundrybuvk.js gzip N/A 154 B -
36dn8i-_3dnq5.js gzip N/A 10 kB -
3bfft0chg6-12.js gzip N/A 159 B -
3fljpmwcjxqhx.js gzip N/A 10.3 kB -
3gz44skqdlsrb.js gzip N/A 8.71 kB -
3tw9or8s8-n7_.js gzip N/A 150 B -
3y9tus7kb5su0.js gzip N/A 13.3 kB -
Total 401 kB 401 kB ✓

Server

Middleware
Canary PR Change
middleware-b..fest.js gzip 1.06 kB 1.06 kB ✓
Total 1.06 kB 1.06 kB ⚠️ +2 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 877 B 878 B ✓
Total 877 B 878 B ⚠️ +1 B
Build Cache
Canary PR Change
00000001.sst gzip 12 MB 15.4 MB 🔴 +3.43 MB (+29%)
00000002.sst gzip 15.3 MB 13.6 MB 🟢 1.74 MB (-11%)
00000003.sst gzip 13.9 MB 15.2 MB 🔴 +1.36 MB (+10%)
00000004.sst gzip 14.3 MB 11.2 MB 🟢 3.07 MB (-22%)
00000005.sst gzip 2.8 MB 10.2 MB 🔴 +7.4 MB (+264%)
00000006.sst gzip 10.2 MB 2.8 MB 🟢 7.44 MB (-73%)
00000007.sst gzip 59 B 59 B ✓
00000008.meta gzip 89 B 89 B ✓
00000009.meta gzip 298 kB 298 kB ✓
00000010.meta gzip 298 kB 298 kB ✓
00000011.meta gzip 298 kB 298 kB ✓
00000012.sst gzip 51.5 kB 52.3 kB 🔴 +838 B (+2%)
00000013.sst gzip 1.83 MB 1.82 MB 🟢 9.73 kB (-1%)
00000014.sst gzip 59 B 59 B ✓
00000015.meta gzip 116 B 116 B ✓
00000016.meta gzip 326 kB 326 kB ✓
00000017.meta gzip 406 kB 406 kB ✓
00000018.sst gzip 52 kB 52.9 kB 🔴 +921 B (+2%)
00000019.sst gzip 1.4 MB 1.38 MB 🟢 22.9 kB (-2%)
00000020.sst gzip 59 B 59 B ✓
00000021.meta gzip 116 B 116 B ✓
00000022.meta gzip 326 kB 326 kB ✓
00000023.meta gzip 372 kB 372 kB ✓
00000024.sst gzip 52 kB 53.1 kB 🔴 +1.07 kB (+2%)
00000025.sst gzip 1.4 MB 1.38 MB 🟢 22.5 kB (-2%)
00000026.sst gzip 59 B 59 B ✓
00000027.meta gzip 116 B 116 B ✓
00000028.meta gzip 326 kB 326 kB ✓
00000029.meta gzip 372 kB 372 kB ✓
00000030.sst gzip 51.8 kB 52.3 kB ✓
00000031.sst gzip 1.4 MB 1.38 MB 🟢 22.7 kB (-2%)
00000032.sst gzip 59 B 59 B ✓
00000033.meta gzip 116 B 116 B ✓
00000034.meta gzip 326 kB 326 kB ✓
00000035.meta gzip 372 kB 372 kB ✓
00000036.sst gzip 51.9 kB 52.8 kB 🔴 +892 B (+2%)
00000037.sst gzip 1.4 MB 1.38 MB 🟢 22.6 kB (-2%)
00000038.sst gzip 59 B 59 B ✓
00000039.meta gzip 116 B 116 B ✓
00000040.meta gzip 326 kB 326 kB ✓
00000041.meta gzip 372 kB 372 kB ✓
CURRENT gzip 94 B 94 B ✓
LOG gzip 682 B 671 B 🟢 11 B (-2%)
Total 80.5 MB 80.4 MB ✅ -156 kB

📦 Webpack

Client

Main Bundles
Canary PR Change
3322-HASH.js gzip 65.5 kB N/A -
4191.HASH.js gzip 169 B N/A -
7920-HASH.js gzip 4.67 kB N/A -
9784-HASH.js gzip 5.63 kB N/A -
b1ad9f4c-HASH.js gzip 63.4 kB N/A -
framework-HASH.js gzip 59.7 kB 59.7 kB ✓
main-app-HASH.js gzip 253 B 252 B ✓
main-HASH.js gzip 40.1 kB 40.1 kB ✓
webpack-HASH.js gzip 1.68 kB 1.68 kB ✓
3577.HASH.js gzip N/A 168 B -
578-HASH.js gzip N/A 66.2 kB -
8590-HASH.js gzip N/A 5.61 kB -
9750-HASH.js gzip N/A 4.68 kB -
a8984546-HASH.js gzip N/A 63.4 kB -
Total 241 kB 242 kB ⚠️ +591 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 194 B 193 B ✓
_error-HASH.js gzip 181 B 182 B ✓
css-HASH.js gzip 334 B 331 B ✓
dynamic-HASH.js gzip 1.81 kB 1.81 kB ✓
edge-ssr-HASH.js gzip 255 B 253 B ✓
head-HASH.js gzip 349 B 351 B ✓
hooks-HASH.js gzip 382 B 384 B ✓
image-HASH.js gzip 581 B 582 B ✓
index-HASH.js gzip 260 B 259 B ✓
link-HASH.js gzip 2.48 kB 2.48 kB ✓
routerDirect..HASH.js gzip 317 B 318 B ✓
script-HASH.js gzip 384 B 386 B ✓
withRouter-HASH.js gzip 316 B 315 B ✓
1afbb74e6ecf..834.css gzip 106 B 106 B ✓
Total 7.95 kB 7.96 kB ⚠️ +4 B

Server

Edge SSR
Canary PR Change
edge-ssr.js gzip 129 kB 129 kB ✓
page.js gzip 294 kB 295 kB ✓
Total 423 kB 423 kB ✅ -37 B
Middleware
Canary PR Change
middleware-b..fest.js gzip 620 B 616 B ✓
middleware-r..fest.js gzip 156 B 156 B ✓
middleware.js gzip 46 kB 45.5 kB 🟢 542 B (-1%)
edge-runtime..pack.js gzip 842 B 842 B ✓
Total 47.7 kB 47.1 kB ✅ -546 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 717 B 718 B ✓
Total 717 B 718 B ⚠️ +1 B
Build Cache
Canary PR Change
0.pack gzip 4.85 MB 4.85 MB 🟢 4.86 kB (0%)
index.pack gzip 122 kB 122 kB ✓
index.pack.old gzip 122 kB 122 kB ✓
Total 5.1 MB 5.09 MB ✅ -5 kB

🔄 Shared (bundler-independent)

Runtimes
Canary PR Change
app-page-exp...dev.js gzip 375 kB 375 kB ✓
app-page-exp..prod.js gzip 207 kB 207 kB ✓
app-page-tur...dev.js gzip 375 kB 375 kB ✓
app-page-tur..prod.js gzip 207 kB 207 kB ✓
app-page-tur...dev.js gzip 371 kB 371 kB ✓
app-page-tur..prod.js gzip 204 kB 204 kB ✓
app-page.run...dev.js gzip 371 kB 371 kB ✓
app-page.run..prod.js gzip 204 kB 204 kB ✓
app-route-ex...dev.js gzip 83.1 kB 83.1 kB ✓
app-route-ex..prod.js gzip 56.2 kB 56.2 kB ✓
app-route-tu...dev.js gzip 83.2 kB 83.2 kB ✓
app-route-tu..prod.js gzip 56.2 kB 56.2 kB ✓
app-route-tu...dev.js gzip 82.7 kB 82.7 kB ✓
app-route-tu..prod.js gzip 56 kB 56 kB ✓
app-route.ru...dev.js gzip 82.7 kB 82.7 kB ✓
app-route.ru..prod.js gzip 55.9 kB 55.9 kB ✓
dev-validati...dev.js gzip 134 kB 134 kB ✓
dev-validati...dev.js gzip 134 kB 134 kB ✓
dev-validati...dev.js gzip 132 kB 132 kB ✓
dev-validati...dev.js gzip 132 kB 132 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 46.6 kB 46.6 kB ✓
pages-api-tu..prod.js gzip 34.7 kB 34.7 kB ✓
pages-api.ru...dev.js gzip 46.6 kB 46.6 kB ✓
pages-api.ru..prod.js gzip 34.7 kB 34.7 kB ✓
pages-turbo....dev.js gzip 55.4 kB 55.4 kB ✓
pages-turbo...prod.js gzip 40.2 kB 40.2 kB ✓
pages.runtim...dev.js gzip 55.3 kB 55.3 kB ✓
pages.runtim..prod.js gzip 40.2 kB 40.2 kB ✓
server.runti..prod.js gzip 67.2 kB 67.2 kB ✓
use-cache-pr...dev.js gzip 72.7 kB 72.7 kB ✓
use-cache-pr...dev.js gzip 72.8 kB 72.8 kB ✓
use-cache-pr...dev.js gzip 71 kB 71 kB ✓
use-cache-pr...dev.js gzip 71 kB 71 kB ✓
Total 4.11 MB 4.11 MB ⚠️ +3 B
📎 Tarball URL 
https://vercel-packages.vercel.app/next/commits/756f3b21a6db2549324ba364209eaf38078de9e5/next

Commit: 756f3b2

@github-actions

github-actions Bot commented Aug 12, 2026 •
edited
Loading

Copy link
Copy Markdown
Contributor

Failing test suites

Commit: 756f3b2 | About building and testing Next.js

pnpm test-dev test/development/acceptance-app/rsc-build-errors-poisoned-imports.test.ts (job)

  • Error overlay - RSC build errors > should error when catchError from next/error is imported in proxy.js (DD)
Expand output

● Error overlay - RSC build errors › should error when catchError from next/error is imported in proxy.js

Expected Redbox but found no visible one.

  124 |
  125 |       const { session } = sandbox
> 126 |       await session.waitForRedbox()
      |       ^
  127 |       expect(await session.getRedboxSource()).toInclude(
  128 |         'You\'re importing a module that depends on `catchError` into a React Server Component module. This API is only available in Client Components. To fix, mark the file (or its parent) with the `"use client"` directive.'
  129 |       )

  at development/acceptance-app/rsc-build-errors-poisoned-imports.test.ts:126:7

pnpm test-dev-turbo test/development/acceptance-app/app-hmr-changes.test.ts (turbopack) (job)

  • Error overlay - RSC build errors > Skipped in webpack > should handle successive HMR changes with errors correctly (DD)
Expand output

● Error overlay - RSC build errors › Skipped in webpack › should handle successive HMR changes with errors correctly

Application is in inconsistent state: timeout.

  114 |             }
  115 |             if (status !== 'pending') {
> 116 |               throw new Error(
      |                     ^
  117 |                 `Application is in inconsistent state: ${status}.`
  118 |               )
  119 |             }

  at Object.patch (lib/development-sandbox.ts:116:21)
  at Object.<anonymous> (development/acceptance-app/app-hmr-changes.test.ts:58:11)

@lubieowoce lubieowoce changed the title Scaffold unstable_navigation() Scaffold navigation() Aug 12, 2026
@lubieowoce
lubieowoce requested a review from unstubbable August 12, 2026 12:08
@lubieowoce
lubieowoce force-pushed the lubieowoce/scaffold-navigation branch 2 times, most recently from 11523bb to 3a17958 Compare August 13, 2026 10:43
@lubieowoce lubieowoce changed the title Scaffold navigation() [PPF] Scaffold navigation() Aug 13, 2026
@lubieowoce
lubieowoce force-pushed the lubieowoce/scaffold-navigation branch 2 times, most recently from 910fe55 to 8a2e618 Compare August 14, 2026 11:31
@lubieowoce
lubieowoce force-pushed the lubieowoce/scaffold-navigation branch from 8a2e618 to 756f3b2 Compare August 14, 2026 15:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@unstubbable unstubbable unstubbable approved these changes

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

2 participants

@lubieowoce @unstubbable