[CC] Rename "unstable_prefetch" to "unstable_instant" by lubieowoce · Pull Request #89448 · vercel/next.js

lubieowoce · 2026-02-03T16:18:45Z

Mostly mechanical.

Also changes the error page to errors/invalid-instant-configuration. I'm not really worried about dangling links here because this is a new API and we don't expect anyone to be using it yet.

lubieowoce · 2026-02-03T16:19:03Z

[Instant] Validate blocking head #89539
[Instant] Instant validation in Dev #89077
[CC] Rename "unstable_prefetch" to "unstable_instant" #89448 👈 (View in Graphite)
canary

This stack of pull requests is managed by Graphite. Learn more about stacking.

vercel

Additional Suggestion:

TypeScript autocomplete snippet for unstable_instant config still uses old name unstable_prefetch

codspeed-hq · 2026-02-03T16:38:53Z

CodSpeed Performance Report

Merging this PR will not alter performance

_{Comparing lubieowoce/rename-prefetch (e06eecd) with canary (12f8545)}

Summary

✅ 17 untouched benchmarks
⏩ 3 skipped benchmarks¹

3 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports. ↩

nextjs-bot · 2026-02-03T16:39:56Z

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)	455ms	455ms	✓	▁▁▁▁▁
Cold (Ready in log)	438ms	439ms	✓	█▇▁▇▂
Cold (First Request)	1.185s	1.182s	✓	██▁█▂
Warm (Listen)	456ms	457ms	✓	▃█▃▃▃
Warm (Ready in log)	443ms	448ms	✓	▃▂▂▃▅
Warm (First Request)	342ms	341ms	✓	▂▄▅██

📦 Dev Server (Webpack) (Legacy)

📦 Dev Server (Webpack)

Metric	Canary	PR	Change	Trend
Cold (Listen)	455ms	456ms	✓	▁▁▁▁█
Cold (Ready in log)	455ms	457ms	✓	▅▄▇▆█
Cold (First Request)	1.944s	1.934s	✓	▃▃▄▃█
Warm (Listen)	457ms	457ms	✓	▁▁▁▁█
Warm (Ready in log)	459ms	458ms	✓	▅▅▅▆█
Warm (First Request)	1.960s	1.941s	✓	▃▂▃▃█

⚡ Production Builds

Metric	Canary	PR	Change	Trend
Fresh Build	3.931s	3.927s	✓	▃▂▃▂█
Cached Build	3.960s	3.875s	✓	▂▂▄▃█

📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric	Canary	PR	Change	Trend
Fresh Build	14.390s	14.426s	✓	▁▁▁▁█
Cached Build	14.496s	14.456s	✓	▂▁▁▁█
node_modules Size	465 MB	465 MB	✓	▁▁▁▁▁

📦 Bundle Sizes

Bundle Sizes

⚡ Turbopack

Client

Main Bundles: **437 kB** → **437 kB** ⚠️ +8 B

81 files with content-based hashes (individual files not comparable between builds)

Server

Middleware

	Canary	PR	Change
middleware-b..fest.js gzip	763 B	767 B	✓
Total	763 B	767 B	⚠️ +4 B

Build Details

Build Manifests

	Canary	PR	Change
_buildManifest.js gzip	451 B	449 B	✓
Total	451 B	449 B	✅ -2 B

📦 Webpack

Client

Main Bundles

	Canary	PR	Change
5528-HASH.js gzip	5.47 kB	N/A	-
6280-HASH.js gzip	56.9 kB	N/A	-
6335.HASH.js gzip	169 B	N/A	-
912-HASH.js gzip	4.53 kB	N/A	-
e8aec2e4-HASH.js gzip	62.5 kB	N/A	-
framework-HASH.js gzip	59.7 kB	59.7 kB	✓
main-app-HASH.js gzip	256 B	254 B	✓
main-HASH.js gzip	39.1 kB	39.1 kB	✓
webpack-HASH.js gzip	1.68 kB	1.68 kB	✓
262-HASH.js gzip	N/A	4.52 kB	-
2889.HASH.js gzip	N/A	169 B	-
5602-HASH.js gzip	N/A	5.48 kB	-
6948ada0-HASH.js gzip	N/A	62.5 kB	-
9544-HASH.js gzip	N/A	57.5 kB	-
Total	230 kB	231 kB	⚠️ +608 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	194 B	✓
_error-HASH.js gzip	183 B	180 B	🟢 3 B (-2%)
css-HASH.js gzip	331 B	330 B	✓
dynamic-HASH.js gzip	1.81 kB	1.81 kB	✓
edge-ssr-HASH.js gzip	256 B	256 B	✓
head-HASH.js gzip	351 B	352 B	✓
hooks-HASH.js gzip	384 B	383 B	✓
image-HASH.js gzip	580 B	581 B	✓
index-HASH.js gzip	260 B	260 B	✓
link-HASH.js gzip	2.49 kB	2.49 kB	✓
routerDirect..HASH.js gzip	320 B	319 B	✓
script-HASH.js gzip	386 B	386 B	✓
withRouter-HASH.js gzip	315 B	315 B	✓
1afbb74e6ecf..834.css gzip	106 B	106 B	✓
Total	7.97 kB	7.97 kB	✅ -1 B

Server

Edge SSR

	Canary	PR	Change
edge-ssr.js gzip	126 kB	126 kB	✓
page.js gzip	249 kB	249 kB	✓
Total	375 kB	375 kB	⚠️ +132 B

Middleware

	Canary	PR	Change
middleware-b..fest.js gzip	616 B	616 B	✓
middleware-r..fest.js gzip	156 B	155 B	✓
middleware.js gzip	33.1 kB	33 kB	✓
edge-runtime..pack.js gzip	842 B	842 B	✓
Total	34.7 kB	34.6 kB	✅ -127 B

Build Details

Build Manifests

	Canary	PR	Change
_buildManifest.js gzip	732 B	736 B	✓
Total	732 B	736 B	⚠️ +4 B

Build Cache

	Canary	PR	Change
0.pack gzip	3.84 MB	3.85 MB	🔴 +9.88 kB (+0%)
index.pack gzip	103 kB	103 kB	✓
index.pack.old gzip	102 kB	104 kB	🔴 +2.65 kB (+3%)
Total	4.05 MB	4.06 MB	⚠️ +12 kB

🔄 Shared (bundler-independent)

Runtimes

	Canary	PR	Change
app-page-exp...dev.js gzip	313 kB	313 kB	✓
app-page-exp..prod.js gzip	167 kB	167 kB	✓
app-page-tur...dev.js gzip	313 kB	313 kB	✓
app-page-tur..prod.js gzip	167 kB	167 kB	✓
app-page-tur...dev.js gzip	309 kB	309 kB	✓
app-page-tur..prod.js gzip	165 kB	165 kB	✓
app-page.run...dev.js gzip	310 kB	310 kB	✓
app-page.run..prod.js gzip	165 kB	165 kB	✓
app-route-ex...dev.js gzip	70.4 kB	70.4 kB	✓
app-route-ex..prod.js gzip	48.9 kB	48.9 kB	✓
app-route-tu...dev.js gzip	70.5 kB	70.5 kB	✓
app-route-tu..prod.js gzip	49 kB	49 kB	✓
app-route-tu...dev.js gzip	70.1 kB	70.1 kB	✓
app-route-tu..prod.js gzip	48.7 kB	48.7 kB	✓
app-route.ru...dev.js gzip	70 kB	70 kB	✓
app-route.ru..prod.js gzip	48.7 kB	48.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	43.2 kB	43.2 kB	✓
pages-api-tu..prod.js gzip	32.9 kB	32.9 kB	✓
pages-api.ru...dev.js gzip	43.1 kB	43.1 kB	✓
pages-api.ru..prod.js gzip	32.8 kB	32.8 kB	✓
pages-turbo....dev.js gzip	52.5 kB	52.5 kB	✓
pages-turbo...prod.js gzip	39.4 kB	39.4 kB	✓
pages.runtim...dev.js gzip	52.4 kB	52.4 kB	✓
pages.runtim..prod.js gzip	39.3 kB	39.3 kB	✓
server.runti..prod.js gzip	62.7 kB	62.7 kB	✓
Total	2.79 MB	2.79 MB	⚠️ +1 B

📝 Changed Files (8 files)

Files with changes:

app-page-exp..ntime.dev.js
app-page-exp..time.prod.js
app-page-tur..ntime.dev.js
app-page-tur..time.prod.js
app-page-tur..ntime.dev.js
app-page-tur..time.prod.js
app-page.runtime.dev.js
app-page.runtime.prod.js

View diffs

app-page-exp..ntime.dev.js

failed to diff

app-page-exp..time.prod.js

Diff too large to display

app-page-tur..ntime.dev.js

failed to diff

app-page-tur..time.prod.js

Diff too large to display

app-page-tur..ntime.dev.js

failed to diff

app-page-tur..time.prod.js

Diff too large to display

app-page.runtime.dev.js

failed to diff

app-page.runtime.prod.js

Diff too large to display

nextjs-bot · 2026-02-03T16:42:39Z

Tests Passed

gnoff

Why not also rename mode to prefetch?

lubieowoce · 2026-02-04T17:12:56Z

@gnoff oh dang, i forgot we wanted to change that too, will update

Mostly mechanical rename. Also changes the error page to `errors/invalid-instant-configuration`. I'm not really worried about dangling links here because this is a new API and we don't expect anyone to be using it yet.

nextjs-bot added created-by: Next.js team PRs by the Next.js team. Documentation Related to Next.js' official documentation. tests Turbopack Related to Turbopack with Next.js. type: next labels Feb 3, 2026

lubieowoce changed the title ~~rename "unstable_prefetch" to "unstable_instant"~~ [CC] Rename "unstable_prefetch" to "unstable_instant" Feb 3, 2026

lubieowoce marked this pull request as ready for review February 3, 2026 16:19

vercel bot reviewed Feb 3, 2026

View reviewed changes

lubieowoce mentioned this pull request Feb 3, 2026

[Instant] Instant validation in Dev #89077

Merged

lubieowoce force-pushed the lubieowoce/rename-prefetch branch from 4698f1f to a0248e3 Compare February 3, 2026 17:08

lubieowoce requested a review from gnoff February 3, 2026 21:34

lubieowoce force-pushed the lubieowoce/rename-prefetch branch from a0248e3 to 36ec4cc Compare February 4, 2026 14:44

gnoff approved these changes Feb 4, 2026

View reviewed changes

rename "unstable_prefetch" to "unstable_instant"

f3a624e

lubieowoce force-pushed the lubieowoce/rename-prefetch branch from 36ec4cc to 7401d75 Compare February 4, 2026 20:13

rename instant.mode -> instant.prefetch

e06eecd

lubieowoce force-pushed the lubieowoce/rename-prefetch branch from 7401d75 to e06eecd Compare February 4, 2026 20:42

lubieowoce merged commit 812996c into canary Feb 4, 2026
163 checks passed

lubieowoce deleted the lubieowoce/rename-prefetch branch February 4, 2026 21:03

lubieowoce mentioned this pull request Feb 5, 2026

[Instant] Validate blocking head #89539

Draft

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[CC] Rename "unstable_prefetch" to "unstable_instant"#89448

[CC] Rename "unstable_prefetch" to "unstable_instant"#89448
lubieowoce merged 2 commits intocanaryfrom
lubieowoce/rename-prefetch

lubieowoce commented Feb 3, 2026 •

edited

Loading

Uh oh!

lubieowoce commented Feb 3, 2026 •

edited

Loading

Uh oh!

vercel bot left a comment

Uh oh!

codspeed-hq bot commented Feb 3, 2026 •

edited

Loading

Uh oh!

nextjs-bot commented Feb 3, 2026 •

edited

Loading

⚡ Dev Server

📦 Dev Server (Webpack)

⚡ Production Builds

📦 Production Builds (Webpack)

Bundle Sizes

⚡ Turbopack

📦 Webpack

🔄 Shared (bundler-independent)

Uh oh!

nextjs-bot commented Feb 3, 2026 •

edited

Loading

Uh oh!

gnoff left a comment

Uh oh!

lubieowoce commented Feb 4, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

lubieowoce commented Feb 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

lubieowoce commented Feb 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

vercel bot left a comment

Choose a reason for hiding this comment

Uh oh!

codspeed-hq bot commented Feb 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

CodSpeed Performance Report

Merging this PR will not alter performance

Summary

Footnotes

Uh oh!

nextjs-bot commented Feb 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Stats from current PR

✅ No significant changes detected

⚡ Dev Server

📦 Dev Server (Webpack)

⚡ Production Builds

📦 Production Builds (Webpack)

Bundle Sizes

⚡ Turbopack

📦 Webpack

🔄 Shared (bundler-independent)

Uh oh!

nextjs-bot commented Feb 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Tests Passed

Uh oh!

gnoff left a comment

Choose a reason for hiding this comment

Uh oh!

lubieowoce commented Feb 4, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

lubieowoce commented Feb 3, 2026 •

edited

Loading

lubieowoce commented Feb 3, 2026 •

edited

Loading

codspeed-hq bot commented Feb 3, 2026 •

edited

Loading

nextjs-bot commented Feb 3, 2026 •

edited

Loading

nextjs-bot commented Feb 3, 2026 •

edited

Loading