Turbopack: experimental.immutableAssetToken by mischnic · Pull Request #88607 · vercel/next.js

mischnic · 2026-01-15T20:39:39Z

This allows specifying a different deployment id for static immutable assets

rename getImmutableAssetToken to getAssetToken (because it can be non-immutable as well)
disable for webpack

Closes PACK-6534

For nextjs/adapter-vercel#25

Part of PACK-6802

nextjs-bot · 2026-01-15T20:40:06Z

Allow CI Workflow Run

approve CI run for commit: 279cfce

Note: this should only be enabled once the PR is ready to go and can only be enabled by a maintainer

nextjs-bot · 2026-01-15T20:40:06Z

Allow CI Workflow Run

approve CI run for commit: 279cfce

Note: this should only be enabled once the PR is ready to go and can only be enabled by a maintainer

mischnic · 2026-01-15T20:40:26Z

Turbopack: experimental.immutableAssetToken #88607 👈 (View in Graphite)
Adapter: STATIC_FILE.immutableHash #90045
tests: Assert dpl query string in all tests for Turbopack #90592
Less dynamic pages manifest path #90581
canary

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

nextjs-bot · 2026-01-15T20:47:49Z

Tests Passed

packages/next/src/client/app-webpack.ts

nextjs-bot · 2026-01-15T21:02:21Z

Stats from current PR

🔴 1 regression

Metric	Canary	PR	Change	Trend
node_modules Size	475 MB	475 MB	🔴 +69.1 kB (+0%)	▁▁▁▁▁

📊 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)	610ms	610ms	✓	▁▁▂▂▁
Cold (Ready in log)	571ms	571ms	✓	▂▁▁▁▂
Cold (First Request)	1.255s	1.246s	✓	▄▁▁▁▄
Warm (Listen)	610ms	610ms	✓	▁▁▁▂▁
Warm (Ready in log)	570ms	569ms	✓	▁▁▁▁▁
Warm (First Request)	441ms	442ms	✓	▁▁▂▂▂

📦 Dev Server (Webpack) (Legacy)

📦 Dev Server (Webpack)

Metric	Canary	PR	Change	Trend
Cold (Listen)	456ms	455ms	✓	▁▁▁▁▁
Cold (Ready in log)	439ms	439ms	✓	▅▂▅▄▆
Cold (First Request)	1.867s	1.873s	✓	▃▁▂▃▃
Warm (Listen)	456ms	456ms	✓	▁▁▁▁▁
Warm (Ready in log)	439ms	440ms	✓	▄▂▄▄▃
Warm (First Request)	1.874s	1.882s	✓	▃▁▃▃▂

⚡ Production Builds

Metric	Canary	PR	Change	Trend
Fresh Build	5.421s	5.454s	✓	▁▂▁▃▁
Cached Build	5.323s	5.393s	✓	▁▂▂▃▁

📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric	Canary	PR	Change	Trend
Fresh Build	14.107s	14.159s	✓	▁▁▁▁▁
Cached Build	14.257s	14.203s	✓	▁▂▁▁▁
node_modules Size	475 MB	475 MB	🔴 +69.1 kB (+0%)	▁▁▁▁▁

📦 Bundle Sizes

Bundle Sizes

⚡ Turbopack

Client

Main Bundles: **400 kB** → **401 kB** ⚠️ +488 B

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

Server

Middleware

	Canary	PR	Change
middleware-b..fest.js gzip	762 B	764 B	✓
Total	762 B	764 B	⚠️ +2 B

Build Details

Build Manifests

	Canary	PR	Change
_buildManifest.js gzip	450 B	451 B	✓
Total	450 B	451 B	⚠️ +1 B

📦 Webpack

Client

Main Bundles

	Canary	PR	Change
5528-HASH.js gzip	5.54 kB	N/A	-
6280-HASH.js gzip	58.4 kB	N/A	-
6335.HASH.js gzip	169 B	N/A	-
912-HASH.js gzip	4.59 kB	N/A	-
e8aec2e4-HASH.js gzip	62.6 kB	N/A	-
framework-HASH.js gzip	59.7 kB	59.7 kB	✓
main-app-HASH.js gzip	256 B	255 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.59 kB	-
2889.HASH.js gzip	N/A	169 B	-
5602-HASH.js gzip	N/A	5.55 kB	-
6948ada0-HASH.js gzip	N/A	62.6 kB	-
9544-HASH.js gzip	N/A	59.1 kB	-
Total	232 kB	233 kB	⚠️ +759 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.5 kB	2.5 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	✅ -2 B

Server

Edge SSR

	Canary	PR	Change
edge-ssr.js gzip	125 kB	125 kB	✓
page.js gzip	254 kB	255 kB	✓
Total	379 kB	379 kB	⚠️ +417 B

Middleware

	Canary	PR	Change
middleware-b..fest.js gzip	617 B	614 B	✓
middleware-r..fest.js gzip	156 B	155 B	✓
middleware.js gzip	43.8 kB	43.9 kB	✓
edge-runtime..pack.js gzip	842 B	842 B	✓
Total	45.4 kB	45.5 kB	⚠️ +47 B

Build Details

Build Manifests

	Canary	PR	Change
_buildManifest.js gzip	715 B	718 B	✓
Total	715 B	718 B	⚠️ +3 B

Build Cache

	Canary	PR	Change
0.pack gzip	4.02 MB	4.03 MB	🔴 +5.45 kB (+0%)
index.pack gzip	103 kB	104 kB	🔴 +1.31 kB (+1%)
index.pack.old gzip	103 kB	102 kB	🟢 1.15 kB (-1%)
Total	4.23 MB	4.23 MB	⚠️ +5.62 kB

🔄 Shared (bundler-independent)

Runtimes

	Canary	PR	Change
app-page-exp...dev.js gzip	320 kB	320 kB	✓
app-page-exp..prod.js gzip	170 kB	170 kB	✓
app-page-tur...dev.js gzip	320 kB	320 kB	✓
app-page-tur..prod.js gzip	170 kB	170 kB	✓
app-page-tur...dev.js gzip	316 kB	316 kB	✓
app-page-tur..prod.js gzip	168 kB	168 kB	✓
app-page.run...dev.js gzip	317 kB	317 kB	✓
app-page.run..prod.js gzip	168 kB	168 kB	✓
app-route-ex...dev.js gzip	70.8 kB	70.8 kB	✓
app-route-ex..prod.js gzip	49.2 kB	49.2 kB	✓
app-route-tu...dev.js gzip	70.8 kB	70.9 kB	✓
app-route-tu..prod.js gzip	49.2 kB	49.3 kB	✓
app-route-tu...dev.js gzip	70.4 kB	70.4 kB	✓
app-route-tu..prod.js gzip	49 kB	49 kB	✓
app-route.ru...dev.js gzip	70.4 kB	70.4 kB	✓
app-route.ru..prod.js gzip	49 kB	49 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.2 kB	43.2 kB	✓
pages-api.ru..prod.js gzip	32.8 kB	32.9 kB	✓
pages-turbo....dev.js gzip	52.5 kB	52.6 kB	✓
pages-turbo...prod.js gzip	38.5 kB	38.5 kB	✓
pages.runtim...dev.js gzip	52.5 kB	52.6 kB	✓
pages.runtim..prod.js gzip	38.4 kB	38.5 kB	✓
server.runti..prod.js gzip	61.9 kB	61.9 kB	✓
Total	2.82 MB	2.82 MB	⚠️ +1.27 kB

📝 Changed Files (25 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
app-route-ex..ntime.dev.js
app-route-ex..time.prod.js
app-route-tu..ntime.dev.js
app-route-tu..time.prod.js
app-route-tu..ntime.dev.js
app-route-tu..time.prod.js
app-route.runtime.dev.js
app-route.ru..time.prod.js
pages-api-tu..ntime.dev.js
pages-api-tu..time.prod.js
pages-api.runtime.dev.js
pages-api.ru..time.prod.js
... and 5 more

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

app-route-ex..ntime.dev.js

Diff too large to display

app-route-ex..time.prod.js

Diff too large to display

app-route-tu..ntime.dev.js

Diff too large to display

app-route-tu..time.prod.js

Diff too large to display

app-route-tu..ntime.dev.js

Diff too large to display

app-route-tu..time.prod.js

Diff too large to display

app-route.runtime.dev.js

Diff too large to display

app-route.ru..time.prod.js

Diff too large to display

pages-api-tu..ntime.dev.js

Diff too large to display

pages-api-tu..time.prod.js

Diff too large to display

pages-api.runtime.dev.js

Diff too large to display

pages-api.ru..time.prod.js

Diff too large to display

pages-turbo...ntime.dev.js

Diff too large to display

pages-turbo...time.prod.js

Diff too large to display

pages.runtime.dev.js

Diff too large to display

pages.runtime.prod.js

Diff too large to display

server.runtime.prod.js

Diff too large to display

📎 Tarball URL

next@https://vercel-packages.vercel.app/next/prs/88607/next

codspeed-hq · 2026-01-15T21:08:18Z

Merging this PR will not alter performance

✅ 17 untouched benchmarks
⏩ 3 skipped benchmarks¹

_{Comparing mischnic/static-deployment-id (9fb9efd) with canary (0b3da78)}

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. ↩

test/unit/next-image-get-img-props.test.ts

vercel · 2026-02-26T17:14:23Z

Notifying the following users due to files changed in this PR based on this repo's notify modifiers:

@timneutkens, @ijjk, @shuding, @huozhi:

packages/next/src/server/config.ts

sokra · 2026-02-27T09:34:00Z

packages/next/src/pages/_document.tsx


  return [...normalScripts, ...lowPriorityScripts].map((file) => {
+    // static/chunks/51e975e7b637a580.js should use the immutable id, while
+    // static/Yj152X97rfGgF7NPcJEZs/_ssgManifest.js should use the deployment id


Having a script tag with the deployment id would break cross deployment ISR. But this is pages router, maybe that expected here?

Yeah, we have to cross that bridge when we get there.

The core problem is that the contents of the ssgManifest are only known after prerendering (when we determine which pages are SSGs), but at that point the HTML with its script tags was already SSGd. So it would need some kind of placeholder-replacement system after SSG.

See PACK-6543

packages/next/src/server/next-server.ts

nextjs-bot added created-by: Turbopack team PRs by the Turbopack team. tests Turbopack Related to Turbopack with Next.js. type: next labels Jan 15, 2026

mischnic changed the title ~~Turbopack: deployment_id_static_assets~~ Turbopack: staticDeploymentId Jan 15, 2026

mischnic changed the title ~~Turbopack: staticDeploymentId~~ Turbopack: assetDeploymentId Jan 15, 2026

mischnic force-pushed the mischnic/static-deployment-id branch from 279cfce to 28f66c6 Compare January 15, 2026 20:44

vercel bot reviewed Jan 15, 2026

View reviewed changes

packages/next/src/client/app-webpack.ts Outdated Show resolved Hide resolved

mischnic force-pushed the mischnic/static-deployment-id branch from 28f66c6 to 6b546d1 Compare January 16, 2026 10:26

vercel bot reviewed Jan 16, 2026

View reviewed changes

test/unit/next-image-get-img-props.test.ts Show resolved Hide resolved

mischnic force-pushed the mischnic/static-deployment-id branch 4 times, most recently from 3e1176a to 1ca7a3a Compare January 16, 2026 14:56

mischnic mentioned this pull request Jan 16, 2026

Turbopack: don't use build id for pages router client-side manifests #88641

Merged

mischnic marked this pull request as ready for review January 16, 2026 19:12

mischnic requested a review from timneutkens January 16, 2026 19:12

mischnic changed the title ~~Turbopack: assetDeploymentId~~ Turbopack: experimental.assetDeploymentId Jan 16, 2026

mischnic force-pushed the mischnic/static-deployment-id branch from 1ca7a3a to 31f10c6 Compare January 19, 2026 09:21

timneutkens approved these changes Jan 19, 2026

View reviewed changes

mischnic marked this pull request as draft January 19, 2026 13:07

mischnic force-pushed the mischnic/static-deployment-id branch from 31f10c6 to c275ea4 Compare January 19, 2026 13:20

mischnic changed the title ~~Turbopack: experimental.assetDeploymentId~~ Turbopack: experimental.immutableDeploymentId Jan 19, 2026

mischnic force-pushed the mischnic/static-deployment-id branch from c275ea4 to e5ba994 Compare February 13, 2026 15:20

nextjs-bot added the Font (next/font) Related to Next.js Font Optimization. label Feb 23, 2026

mischnic force-pushed the mischnic/static-deployment-id branch 2 times, most recently from 9a87bfd to fe5303e Compare February 23, 2026 16:44

mischnic changed the base branch from canary to graphite-base/88607 February 24, 2026 09:17

mischnic force-pushed the mischnic/static-deployment-id branch from 09eaa0c to 89d6a76 Compare February 24, 2026 09:17

mischnic changed the base branch from graphite-base/88607 to mischnic/fix-next-image-unoptimized February 24, 2026 09:17

sokra reviewed Feb 27, 2026

View reviewed changes

packages/next/src/server/next-server.ts Outdated Show resolved Hide resolved

sokra approved these changes Feb 27, 2026

View reviewed changes

mischnic added 11 commits February 27, 2026 09:52

Turbopack: immutable_deployment_id

08953d7

switch to immutable_deployment_id

c963c1c

read VERCEL_IMMUTABLE_DEPLOYMENT_ID in tests

e6cf733

deployment id for Pages client manifests

c748519

adjust NEXT_CLIENT_ASSET_SUFFIX

8a2ee0e

NextInstance.immutableAssetToken

5999473

add test

2e535c4

assert immutable token in tests

37ecd16

enable

f6c9c29

rename internal fields to clientAssetToken

cc96b15

call it __NEXT_IMMUTABLE_ASSET_TOKEN

74f0d03

sokra approved these changes Feb 27, 2026

View reviewed changes

fix config normalization

9fb9efd

timneutkens approved these changes Feb 27, 2026

View reviewed changes

Conversation

mischnic commented Jan 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

nextjs-bot commented Jan 15, 2026

Uh oh!

nextjs-bot commented Jan 15, 2026

Uh oh!

mischnic commented Jan 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

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

Uh oh!

Tests Passed

Uh oh!

Uh oh!

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

Uh oh!

Stats from current PR

🔴 1 regression

⚡ Dev Server

📦 Dev Server (Webpack)

⚡ Production Builds

📦 Production Builds (Webpack)

Bundle Sizes

⚡ Turbopack

📦 Webpack

🔄 Shared (bundler-independent)

Uh oh!

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

Uh oh!

Merging this PR will not alter performance

Footnotes

Uh oh!

Uh oh!

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

Uh oh!

Uh oh!

sokra Feb 27, 2026

Choose a reason for hiding this comment

Uh oh!

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

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

mischnic commented Jan 15, 2026 •

edited

Loading

mischnic commented Jan 15, 2026 •

edited

Loading

nextjs-bot commented Jan 15, 2026 •

edited

Loading

nextjs-bot commented Jan 15, 2026 •

edited

Loading

codspeed-hq bot commented Jan 15, 2026 •

edited

Loading

vercel bot commented Feb 26, 2026 •

edited

Loading

mischnic Feb 27, 2026 •

edited

Loading