Skip to content

Scaffold navigation() - #97236

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

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 regression, 1 improvement

Metric Canary PR Change Trend
Webpack Build Time (cached) 24.003s 24.614s 🔴 +611ms (+3%) ▄▅▂█▁
Webpack Build Time 24.797s 23.979s 🟢 818ms (-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) 789ms 790ms ✓ ▆▁█▄▁
Cold (First Request) 1.290s 1.334s ✓ ▅▁█▂▁
Warm (Listen) 813ms 813ms ✓ █▁███
Warm (Ready in log) 786ms 803ms ✓ ▅▁▆▄▁
Warm (First Request) 1.281s 1.330s ✓ ▄▁▇▂▁
📦 Dev Server (Webpack) (Legacy)

📦 Dev Server (Webpack)

Metric Canary PR Change Trend
Cold (Listen) 812ms 813ms ✓ ████▁
Cold (Ready in log) 775ms 788ms ✓ ▄▇▂▇▁
Cold (First Request) 3.293s 3.388s ✓ ▂▆▁▆▁
Warm (Listen) 812ms 813ms ✓ ████▁
Warm (Ready in log) 775ms 787ms ✓ ▃▄▂▇▁
Warm (First Request) 3.316s 3.409s ✓ ▂▂▁█▁

⚡ Production Builds

Metric Canary PR Change Trend
Fresh Build 5.677s 5.656s ✓ ▆▂▇▂▁
Cached Build 2.914s 2.942s ✓ ▃▁▆▂▁
📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric Canary PR Change Trend
Fresh Build 24.797s 23.979s 🟢 818ms (-3%) ▃▄▂█▁
Cached Build 24.003s 24.614s 🔴 +611ms (+3%) ▄▅▂█▁
node_modules Size 553 MB 553 MB ✓ ▁▁███
📦 Bundle Sizes

Bundle Sizes

⚡ Turbopack

Client

Main Bundles
Canary PR Change
0-qgm0nju2p_g.js gzip 65.6 kB N/A -
03lzpt71kg1qg.js gzip 47 kB N/A -
050icza-xjz0i.js gzip 5.73 kB N/A -
07jdby0ue616s.js gzip 450 B N/A -
09h-pq0amxnxn.js gzip 155 B N/A -
0bjdc8muo74n5.js gzip 8.71 kB N/A -
0cz1d0mv5g_q7.js gzip 39.4 kB 39.4 kB ✓
0d96sdjnk6_q2.js gzip 160 B N/A -
0h65-ko13bi2v.js gzip 154 B N/A -
0l9a54rsx_muy.js gzip 169 B N/A -
0q36apx7b1q_e.js gzip 7.54 kB N/A -
0rci1f3or1a19.js gzip 13.3 kB N/A -
0s56j06e963lv.js gzip 157 B N/A -
0vh9avwq65kiy.js gzip 156 B N/A -
1_2x714--ii1i.js gzip 8.76 kB N/A -
1-3y752pkth5-.js gzip 10 kB N/A -
10l611mm67gac.js gzip 71.6 kB N/A -
1elt1qium-r2m.css gzip 115 B 115 B ✓
1k6dd7su4cfei.js gzip 3.57 kB N/A -
1kpy40fd-pusb.js gzip 154 B N/A -
1tf1phijqlx9j.js gzip 220 B 220 B ✓
1uzabyd1120a1.js gzip 8.71 kB N/A -
2_uglbwqpe26b.js gzip 156 B N/A -
2-ufv8lc-g7gg.js gzip 10.6 kB N/A -
21kmjy_10x14f.js gzip 8.81 kB N/A -
28dhc6t85q1_p.js gzip 8.78 kB N/A -
29vdii-hrinxo.js gzip 154 B N/A -
2f-ilvczue-tp.js gzip 9.46 kB N/A -
2f1u17u5c8iny.js gzip 8.79 kB N/A -
2ikltg_8iegxw.js gzip 10.3 kB N/A -
2vxi673cz1-t4.js gzip 8.79 kB N/A -
38-q43pzktqhs.js gzip 1.46 kB N/A -
3dpw0m5_58h1u.js gzip 160 B N/A -
3gq5gsxwg_yl5.js gzip 151 B N/A -
3mrwxzed0ylgv.js gzip 13.1 kB N/A -
3nbojhxiy1qv_.js gzip 13.7 kB N/A -
3p8f-2kolq65a.js gzip 157 B N/A -
3qmtac2p5up_2.js gzip 156 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 -
00i5e2bmvcp3b.js gzip N/A 155 B -
07ryk0jced-sc.js gzip N/A 8.78 kB -
0jwho9fkrb_t3.js gzip N/A 2.29 kB -
0k32-8va-4evm.js gzip N/A 155 B -
0rd26mgng5fzz.js gzip N/A 153 B -
0roh390ijzxa5.js gzip N/A 8.75 kB -
0vex9w55ursqj.js gzip N/A 8.79 kB -
0xnnl2qx2x7bz.js gzip N/A 158 B -
17oe55cu76cd7.js gzip N/A 450 B -
17vqy5qzu8dz5.js gzip N/A 167 B -
1drww5xikb-c-.js gzip N/A 9.46 kB -
1g60xde_dv17t.js gzip N/A 8.79 kB -
1kp8dhziabfib.js gzip N/A 154 B -
1tk8-jw7z6hlb.js gzip N/A 149 B -
1uzv47btzam64.js gzip N/A 5.73 kB -
1vy7n7wxv_rh5.js gzip N/A 8.81 kB -
2_uqyv_-jqnh5.js gzip N/A 65.6 kB -
2-0i7pl900-ou.js gzip N/A 8.71 kB -
2-kcbngm7ik7y.js gzip N/A 8.75 kB -
26zt1nty--7dt.js gzip N/A 155 B -
29p5-xa4jmdhg.js gzip N/A 13.7 kB -
2hzkpmnvy0nyg.js gzip N/A 71.6 kB -
2lpk5_hknut8q.js gzip N/A 13.1 kB -
2o4cibp3awtbw.js gzip N/A 3.56 kB -
2rvrvr5m-ct0q.js gzip N/A 155 B -
2ugc69z0t0ypz.js gzip N/A 1.46 kB -
3-_0ow7671xjh.js gzip N/A 7.55 kB -
36dn8i-_3dnq5.js gzip N/A 10 kB -
3bvjff6jbedao.js gzip N/A 155 B -
3fljpmwcjxqhx.js gzip N/A 10.3 kB -
3fula_ahie2iv.js gzip N/A 160 B -
3gz44skqdlsrb.js gzip N/A 8.71 kB -
3he_ygd-gghew.js gzip N/A 153 B -
3nk46g6u37ekv.js gzip N/A 47 kB -
3t-wn5cs8eke0.js gzip N/A 155 B -
3y9tus7kb5su0.js gzip N/A 13.3 kB -
Total 401 kB 401 kB ✅ -4 B

Server

Middleware
Canary PR Change
middleware-b..fest.js gzip 1.05 kB 1.06 kB ✓
Total 1.05 kB 1.06 kB ⚠️ +2 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 876 B 874 B ✓
Total 876 B 874 B ✅ -2 B
Build Cache
Canary PR Change
00000001.sst gzip 14 MB 15.5 MB 🔴 +1.56 MB (+11%)
00000002.sst gzip 13.7 MB 14.2 MB 🔴 +525 kB (+4%)
00000003.sst gzip 13.6 MB 14.2 MB 🔴 +613 kB (+5%)
00000004.sst gzip 13.8 MB 11.1 MB 🟢 2.7 MB (-20%)
00000005.sst gzip 10.2 MB 10.2 MB 🔴 +28.4 kB (+0%)
00000006.sst gzip 2.8 MB 2.8 MB ✓
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 kB 52.1 kB 🔴 +1.07 kB (+2%)
00000013.sst gzip 1.77 MB 1.83 MB 🔴 +64.1 kB (+4%)
00000014.sst gzip 59 B 59 B ✓
00000015.meta gzip 116 B 116 B ✓
00000016.meta gzip 326 kB 326 kB ✓
00000017.meta gzip 405 kB 406 kB ✓
00000018.sst gzip 51.8 kB 52.9 kB 🔴 +1.13 kB (+2%)
00000019.sst gzip 1.38 MB 1.39 MB 🔴 +13.7 kB (+1%)
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 51.9 kB 53 kB 🔴 +1.16 kB (+2%)
00000025.sst gzip 1.38 MB 1.39 MB 🔴 +14.3 kB (+1%)
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.2 kB 52.2 kB 🔴 +994 B (+2%)
00000031.sst gzip 1.38 MB 1.39 MB 🔴 +14.2 kB (+1%)
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.8 kB 52.8 kB 🔴 +997 B (+2%)
00000037.sst gzip 1.38 MB 1.39 MB 🔴 +14.3 kB (+1%)
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 685 B 666 B 🟢 19 B (-3%)
Total 80 MB 80.2 MB ⚠️ +144 kB

📦 Webpack

Client

Main Bundles
Canary PR Change
3322-HASH.js gzip 66.2 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.2 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.8 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.2 kB -
Total 242 kB 242 kB ⚠️ +618 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 294 kB ✓
Total 423 kB 423 kB ✅ -53 B
Middleware
Canary PR Change
middleware-b..fest.js gzip 617 B 616 B ✓
middleware-r..fest.js gzip 156 B 156 B ✓
middleware.js gzip 45.8 kB 45.7 kB ✓
edge-runtime..pack.js gzip 842 B 842 B ✓
Total 47.5 kB 47.3 kB ✅ -184 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.8 MB 4.8 MB ✓
index.pack gzip 122 kB 122 kB ✓
index.pack.old gzip 121 kB 122 kB ✓
Total 5.05 MB 5.05 MB ✅ -1.43 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 374 kB 374 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 205 kB 205 kB ✓
app-route-ex...dev.js gzip 82.9 kB 82.9 kB ✓
app-route-ex..prod.js gzip 56.1 kB 56.1 kB ✓
app-route-tu...dev.js gzip 83 kB 83 kB ✓
app-route-tu..prod.js gzip 56.1 kB 56.1 kB ✓
app-route-tu...dev.js gzip 82.5 kB 82.5 kB ✓
app-route-tu..prod.js gzip 55.9 kB 55.9 kB ✓
app-route.ru...dev.js gzip 82.5 kB 82.5 kB ✓
app-route.ru..prod.js gzip 55.8 kB 55.8 kB ✓
dev-validati...dev.js gzip 134 kB 134 kB ✓
dev-validati...dev.js gzip 134 kB 134 kB ✓
dev-validati...dev.js gzip 131 kB 131 kB ✓
dev-validati...dev.js gzip 131 kB 131 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.4 kB 46.4 kB ✓
pages-api-tu..prod.js gzip 34.6 kB 34.6 kB ✓
pages-api.ru...dev.js gzip 46.4 kB 46.4 kB ✓
pages-api.ru..prod.js gzip 34.5 kB 34.5 kB ✓
pages-turbo....dev.js gzip 55.2 kB 55.2 kB ✓
pages-turbo...prod.js gzip 40.1 kB 40.1 kB ✓
pages.runtim...dev.js gzip 55.1 kB 55.1 kB ✓
pages.runtim..prod.js gzip 40.1 kB 40.1 kB ✓
server.runti..prod.js gzip 67.1 kB 67.1 kB ✓
use-cache-pr...dev.js gzip 72.6 kB 72.6 kB ✓
use-cache-pr...dev.js gzip 72.6 kB 72.6 kB ✓
use-cache-pr...dev.js gzip 70.8 kB 70.8 kB ✓
use-cache-pr...dev.js gzip 70.8 kB 70.8 kB ✓
Total 4.11 MB 4.11 MB ✅ -4 B
📎 Tarball URL 
https://vercel-packages.vercel.app/next/commits/11523bbeedcf9fb665f64e821f235ea4556d7da2/next

Commit: 11523bb

@github-actions

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

Copy link
Copy Markdown
Contributor

Failing test suites

Commit: 11523bb | About building and testing Next.js

pnpm test-dev test/e2e/app-dir/back-before-hydration/back-before-hydration.test.ts (job)

  • back navigation before hydration after reload > Suspense boundary above the page > reconciles the URL with the rendered content once hydration completes (DD)
  • back navigation before hydration after reload > Suspense boundary above the page > other history changes before hydration > leaves the traversal unhandled when a third-party write lands before the replay (DD)
  • back navigation before hydration after reload > no Suspense boundary above the page > reconciles the URL with the rendered content once hydration completes (DD)
  • back navigation before hydration after reload > no Suspense boundary above the page > reconciles when the traversed entry differs only in search params (DD)
Expand output

● back navigation before hydration after reload › no Suspense boundary above the page › reconciles the URL with the rendered content once hydration completes

expect(received).toBe(expected) // Object.is equality

Expected: "Home"
Received: "Post"

  127 |       await retry(async () => {
  128 |         expect(new URL(await browser.url()).pathname).toBe(homePath)
> 129 |         expect(await browser.elementByCss('h1').text()).toBe('Home')
      |                                                         ^
  130 |       })
  131 |
  132 |       // History traversal must still work after recovery.

  at toBe (e2e/app-dir/back-before-hydration/back-before-hydration.test.ts:129:57)
  at retry (lib/next-test-utils.ts:868:14)
  at Object.<anonymous> (e2e/app-dir/back-before-hydration/back-before-hydration.test.ts:127:7)

● back navigation before hydration after reload › no Suspense boundary above the page › reconciles when the traversed entry differs only in search params

expect(received).toBe(expected) // Object.is equality

Expected: "Page 1"
Received: "Page 2"

  158 |       await retry(async () => {
  159 |         expect(new URL(await browser.url()).search).toBe('?page=1')
> 160 |         expect(await browser.elementByCss('h1').text()).toBe('Page 1')
      |                                                         ^
  161 |       })
  162 |
  163 |       await browser.forward()

  at toBe (e2e/app-dir/back-before-hydration/back-before-hydration.test.ts:160:57)
  at retry (lib/next-test-utils.ts:868:14)
  at Object.<anonymous> (e2e/app-dir/back-before-hydration/back-before-hydration.test.ts:158:7)

● back navigation before hydration after reload › Suspense boundary above the page › reconciles the URL with the rendered content once hydration completes

expect(received).toBe(expected) // Object.is equality

Expected: "Home"
Received: "Post"

  127 |       await retry(async () => {
  128 |         expect(new URL(await browser.url()).pathname).toBe(homePath)
> 129 |         expect(await browser.elementByCss('h1').text()).toBe('Home')
      |                                                         ^
  130 |       })
  131 |
  132 |       // History traversal must still work after recovery.

  at toBe (e2e/app-dir/back-before-hydration/back-before-hydration.test.ts:129:57)
  at retry (lib/next-test-utils.ts:868:14)
  at Object.<anonymous> (e2e/app-dir/back-before-hydration/back-before-hydration.test.ts:127:7)

● back navigation before hydration after reload › Suspense boundary above the page › other history changes before hydration › leaves the traversal unhandled when a third-party write lands before the replay

expect(received).toBe(expected) // Object.is equality

Expected: "?tp=1"
Received: ""

  298 |           // particular the router must not reload a page that just loaded.
  299 |           expect(await browser.eval('window.__stayed')).toBe(true)
> 300 |           expect(new URL(await browser.url()).search).toBe('?tp=1')
      |                                                       ^
  301 |           expect(await browser.elementByCss('h1').text()).toBe('Post')
  302 |         })
  303 |

  at toBe (e2e/app-dir/back-before-hydration/back-before-hydration.test.ts:300:55)
  at retry (lib/next-test-utils.ts:868:14)
  at Object.<anonymous> (e2e/app-dir/back-before-hydration/back-before-hydration.test.ts:295:9)

@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 from 19febc6 to 11523bb Compare August 12, 2026 14:43
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