Replace PPR config helpers with cacheComponents checks by devjiwonchoi · Pull Request #90704 · vercel/next.js

devjiwonchoi · 2026-02-28T21:46:36Z

This PR replaces the legacy PPR configs in the codebase with the cacheComponents config.

Confirmed deployment test passes https://github.com/vercel/next.js/actions/runs/22533307017

The `cacheComponents` flag already auto-enables `experimental.ppr` during config normalization (config.ts line 1399), making the PPR helper functions `checkIsAppPPREnabled` and `checkIsRoutePPREnabled` just unnecessary indirection. This consolidates PPR configuration to a single source of truth. Since users cannot set `experimental.ppr` directly (throws HardDeprecatedConfigError), the behavior is unchanged when replacing PPR config checks with direct `cacheComponents` checks. This is the first PR of a 3-part series to safely remove legacy PPR code incrementally.

nextjs-bot · 2026-02-28T22:07:39Z

Tests Passed

nextjs-bot · 2026-02-28T23:42:00Z

Stats from current PR

🟢 1 improvement

Metric	Canary	PR	Change	Trend
node_modules Size	475 MB	475 MB	🟢 52.8 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)	456ms	455ms	✓	▁▁▁█▁
Cold (Ready in log)	443ms	443ms	✓	▂▂▁█▁
Cold (First Request)	890ms	891ms	✓	▄▄▁█▁
Warm (Listen)	456ms	456ms	✓	▁▁▁█▁
Warm (Ready in log)	439ms	441ms	✓	▁▁▁█▁
Warm (First Request)	347ms	351ms	✓	▁▁▁█▁

📦 Dev Server (Webpack) (Legacy)

📦 Dev Server (Webpack)

Metric	Canary	PR	Change	Trend
Cold (Listen)	455ms	456ms	✓	▁▁▁▁▁
Cold (Ready in log)	436ms	437ms	✓	▂▃▁▁▃
Cold (First Request)	1.843s	1.840s	✓	▂▁▁▁▂
Warm (Listen)	455ms	456ms	✓	▁▁▁▁▁
Warm (Ready in log)	435ms	436ms	✓	▂▂▁▁▃
Warm (First Request)	1.871s	1.864s	✓	▁▁▁▁▂

⚡ Production Builds

Metric	Canary	PR	Change	Trend
Fresh Build	4.188s	4.162s	✓	▁▁▃█▁
Cached Build	4.119s	4.172s	✓	▁▁▃█▁

📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric	Canary	PR	Change	Trend
Fresh Build	13.962s	14.026s	✓	▁▁▁▁▁
Cached Build	14.186s	14.083s	✓	▁▁▁▁▁
node_modules Size	475 MB	475 MB	🟢 52.8 kB (0%)	▁▁▁▁▁

📦 Bundle Sizes

Bundle Sizes

⚡ Turbopack

Client

Main Bundles: **401 kB** → **401 kB** ✅ -23 B

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

Server

Middleware

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

Build Details

Build Manifests

	Canary	PR	Change
_buildManifest.js gzip	449 B	450 B	✓
Total	449 B	450 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	253 B	253 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	⚠️ +701 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	254 kB	✓
Total	379 kB	379 kB	⚠️ +150 B

Middleware

	Canary	PR	Change
middleware-b..fest.js gzip	616 B	615 B	✓
middleware-r..fest.js gzip	156 B	155 B	✓
middleware.js gzip	43.9 kB	43.9 kB	✓
edge-runtime..pack.js gzip	842 B	842 B	✓
Total	45.5 kB	45.5 kB	✅ -33 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.02 MB	🟢 4.78 kB (0%)
index.pack gzip	102 kB	101 kB	🟢 1.23 kB (-1%)
index.pack.old gzip	103 kB	103 kB	✓
Total	4.23 MB	4.22 MB	✅ -5.53 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	169 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.9 kB	70.9 kB	✓
app-route-tu..prod.js gzip	49.3 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.9 kB	32.9 kB	✓
pages-turbo....dev.js gzip	52.6 kB	52.6 kB	✓
pages-turbo...prod.js gzip	38.5 kB	38.5 kB	✓
pages.runtim...dev.js gzip	52.6 kB	52.6 kB	✓
pages.runtim..prod.js gzip	38.5 kB	38.5 kB	✓
server.runti..prod.js gzip	61.9 kB	61.9 kB	✓
Total	2.82 MB	2.82 MB	✅ -214 B

📝 Changed Files (9 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
server.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

Diff too large to display

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

failed to diff

app-page.runtime.dev.js

Diff too large to display

app-page.runtime.prod.js

failed to diff

server.runtime.prod.js

Diff too large to display

📎 Tarball URL

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

vercel · 2026-03-01T02:32:01Z

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

unstubbable · 2026-03-04T12:27:13Z

packages/next/src/build/analyze/index.ts

  )

-  const isAppPPREnabled = checkIsAppPPREnabled(config.experimental.ppr)
+  const isAppPPREnabled = !!config.cacheComponents


rename the const as well

unstubbable · 2026-03-04T12:28:00Z

packages/next/src/build/templates/app-page.ts

-  const couldSupportPPR: boolean = checkIsAppPPREnabled(
-    nextConfig.experimental.ppr
-  )
+  const couldSupportPPR: boolean = !!nextConfig.cacheComponents


rename the const as well

unstubbable · 2026-03-04T12:28:38Z

packages/next/src/build/index.ts

        config.experimental.authInterrupts
      )
-      const isAppPPREnabled = checkIsAppPPREnabled(config.experimental.ppr)
+      const isAppPPREnabled = isAppCacheComponentsEnabled


use isAppCacheComponentsEnabled at the usage sites

unstubbable · 2026-03-04T12:30:04Z

packages/next/src/build/index.ts

-                  ? checkIsRoutePPREnabled(config.experimental.ppr)
-                  : false
+                const isRoutePPREnabled: boolean =
+                  !!appConfig && isAppCacheComponentsEnabled


note to self: this gets removed in the upstack PR

unstubbable · 2026-03-04T12:52:27Z

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

   * The Partial Prerendering feature is still available via `cacheComponents`.
   */
-  ppr?: ExperimentalPPRConfig
+  ppr?: boolean | 'incremental'


Will this be removed in an upstack PR?

In this PR, the entire file is deleted: packages/next/src/server/lib/experimental/ppr.ts forExperimentalPPRConfig

EDIT: Do you mean the ppr option?

Co-authored-by: Hendrik Liebau <mail@hendrik-liebau.de>

devjiwonchoi · 2026-03-04T13:35:48Z

@codex review

chatgpt-codex-connector · 2026-03-04T13:42:29Z

Codex Review: Didn't find any major issues. Another round soon, please!

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

nextjs-bot · 2026-03-04T13:49:42Z

Tests Passed

…anch (#90713) Stacked on #90704 This PR replaces `experimental.isRoutePPREnabled` render options with `cacheComponents` and removes unused code. Verified deployment tests pass on CI: https://github.com/vercel/next.js/actions/runs/22536405880

This reverts commit 70a2e8d.

This PR replaces the legacy PPR configs in the codebase with the `cacheComponents` config. Confirmed deployment test passes https://github.com/vercel/next.js/actions/runs/22533307017 --------- Co-authored-by: Hendrik Liebau <mail@hendrik-liebau.de>

…anch (#90713) Stacked on #90704 This PR replaces `experimental.isRoutePPREnabled` render options with `cacheComponents` and removes unused code. Verified deployment tests pass on CI: https://github.com/vercel/next.js/actions/runs/22536405880

nextjs-bot added created-by: Next.js team PRs by the Next.js team. type: next labels Feb 28, 2026

devjiwonchoi marked this pull request as ready for review March 1, 2026 02:31

devjiwonchoi requested a review from unstubbable March 1, 2026 02:32

This was referenced Mar 1, 2026

Remove isRoutePPREnabled from render options and delete dead PPR branch #90713

Merged

Remove PrerenderStorePPR type and all prerender-ppr switch cases #90721

Merged

unstubbable reviewed Mar 4, 2026

View reviewed changes

Sync var names to usage

46f48f7

Co-authored-by: Hendrik Liebau <mail@hendrik-liebau.de>

devjiwonchoi requested a review from unstubbable March 4, 2026 13:59

unstubbable approved these changes Mar 4, 2026

View reviewed changes

devjiwonchoi enabled auto-merge (squash) March 4, 2026 14:07

devjiwonchoi merged commit 70a2e8d into canary Mar 4, 2026
535 of 545 checks passed

devjiwonchoi deleted the jiwon-2026-02-28/pr-89648-review branch March 4, 2026 14:56

unstubbable added a commit that referenced this pull request Mar 5, 2026

Revert "Replace PPR config helpers with cacheComponents checks (#90704)"

ee3a59f

This reverts commit 70a2e8d.

unstubbable added a commit that referenced this pull request Mar 5, 2026

Revert "Replace PPR config helpers with cacheComponents checks (#90704)"

3559782

This reverts commit 70a2e8d.

Conversation

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

Uh oh!

Uh oh!

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

Uh oh!

Tests Passed

Uh oh!

nextjs-bot commented Feb 28, 2026

Stats from current PR

🟢 1 improvement

⚡ Dev Server

📦 Dev Server (Webpack)

⚡ Production Builds

📦 Production Builds (Webpack)

Bundle Sizes

⚡ Turbopack

📦 Webpack

🔄 Shared (bundler-independent)

Uh oh!

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

Uh oh!

Uh oh!

unstubbable Mar 4, 2026

Choose a reason for hiding this comment

Uh oh!

unstubbable Mar 4, 2026

Choose a reason for hiding this comment

Uh oh!

unstubbable Mar 4, 2026

Choose a reason for hiding this comment

Uh oh!

unstubbable Mar 4, 2026

Choose a reason for hiding this comment

Uh oh!

unstubbable Mar 4, 2026

Choose a reason for hiding this comment

Uh oh!

devjiwonchoi Mar 4, 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!

devjiwonchoi commented Mar 4, 2026

Uh oh!

chatgpt-codex-connector bot commented Mar 4, 2026

Uh oh!

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

Uh oh!

Tests Passed

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

devjiwonchoi commented Feb 28, 2026 •

edited

Loading

nextjs-bot commented Feb 28, 2026 •

edited by devjiwonchoi

Loading

vercel bot commented Mar 1, 2026 •

edited

Loading

devjiwonchoi Mar 4, 2026 •

edited

Loading

nextjs-bot commented Mar 4, 2026 •

edited

Loading