Skip to content

refactor: consolidate PPR into cacheComponents architecture #88243

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Merged
wyattjoh merged 1 commit into from
Jan 9, 2026
Merged

refactor: consolidate PPR into cacheComponents architecture #88243

wyattjoh merged 1 commit into from
Jan 9, 2026

Conversation

@wyattjoh
Copy link
Member

@wyattjoh wyattjoh commented Jan 7, 2026 •
edited
Loading

What?

Removes the experimental.ppr configuration flag and consolidates Partial Prerendering (PPR) functionality into the cacheComponents architecture.

Why?

Having two separate systems (PPR flag and cacheComponents) created dual code paths and complexity. PPR is now implicitly enabled when cacheComponents is enabled, simplifying the codebase.

How?

  • Deleted postpone.ts and ppr.ts utility files
  • Removed PrerenderStorePPR work unit type and all PPR-specific work unit cases
  • Removed React.unstable_postpone-based dynamic rendering logic
  • Deprecated experimental.ppr config (kept for backwards compatibility)
  • Simplified build system to check only cacheComponents flag
  • Updated tests to remove PPR-specific behavior expectations

This removes ~986 lines of code across 48 files.

NAR-490

@wyattjoh
refactor: consolidate PPR into cacheComponents architecture
a507a36 
Removes the experimental.ppr configuration flag and consolidates Partial
Prerendering (PPR) functionality into the cacheComponents architecture.

Key changes:
- Delete postpone.ts and ppr.ts utility files
- Remove PrerenderStorePPR work unit type
- Remove React.unstable_postpone-based dynamic rendering
- Deprecate experimental.ppr config (PPR now implicit with cacheComponents)
- Simplify build system PPR detection
- Update tests to remove PPR-specific expectations

This unifies the two parallel rendering systems into one cacheComponents-based approach.
@wyattjoh Graphite App
Copy link
Member Author

wyattjoh commented Jan 7, 2026

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

@nextjs-bot
Copy link
Collaborator

nextjs-bot commented Jan 7, 2026

Stats from current PR

🟢 1 improvement

Metric Canary PR Change Trend
node_modules Size 457 MB 456 MB 🟢 939 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) 455ms 455ms ✓ █▁▁▁▃
Cold (First Request) 845ms 841ms ✓ ▂█▇█▁
Warm (Listen) 455ms 456ms ✓ ██▁█▁
Warm (First Request) 346ms 382ms ✓ ██▁▁▁
📦 Dev Server (Webpack) (Legacy)

📦 Dev Server (Webpack)

Metric Canary PR Change Trend
Cold (Listen) 455ms 455ms ✓ ▁▁▁▁▁
Cold (First Request) 1.842s 1.825s ✓ ▂▁▁▂▁
Warm (Listen) 456ms 457ms ✓ ▁▁▁▁▁
Warm (First Request) 1.834s 1.836s ✓ ▁▁▁▂▁

⚡ Production Builds

Metric Canary PR Change Trend
Fresh Build 4.428s 4.433s ✓ █▂▁▂▆
Cached Build 4.486s 4.473s ✓ █▁▂▁▅
📦 Production Builds (Webpack) (Legacy)

📦 Production Builds (Webpack)

Metric Canary PR Change Trend
Fresh Build 13.987s 13.893s ✓ ▁▁▁▁▁
Cached Build 14.126s 14.134s ✓ ▁▁▁▁▁
node_modules Size 457 MB 456 MB 🟢 939 kB (0%) ▁▁▁▁▁
📦 Bundle Sizes

Bundle Sizes

⚡ Turbopack

Client

Main Bundles: **431 kB** → **430 kB** ✅ -566 B

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

Server

Middleware
Canary PR Change
middleware-b..fest.js gzip 786 B 782 B ✓
Total 786 B 782 B ✅ -4 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 451 B 450 B ✓
Total 451 B 450 B ✅ -1 B

📦 Webpack

Client

Main Bundles
Canary PR Change
2086.HASH.js gzip 169 B N/A -
2161-HASH.js gzip 5.4 kB N/A -
2747-HASH.js gzip 4.48 kB N/A -
4322-HASH.js gzip 52.7 kB N/A -
ec793fe8-HASH.js gzip 62.3 kB N/A -
framework-HASH.js gzip 59.8 kB 59.8 kB ✓
main-app-HASH.js gzip 250 B 254 B 🔴 +4 B (+2%)
main-HASH.js gzip 38.6 kB 38.9 kB ✓
webpack-HASH.js gzip 1.68 kB 1.68 kB ✓
1596.HASH.js gzip N/A 169 B -
2658-HASH.js gzip N/A 52.5 kB -
6349-HASH.js gzip N/A 4.46 kB -
7019-HASH.js gzip N/A 5.42 kB -
b17a3386-HASH.js gzip N/A 62.3 kB -
Total 225 kB 225 kB ⚠️ +160 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 182 B 182 B ✓
css-HASH.js gzip 336 B 335 B ✓
dynamic-HASH.js gzip 1.8 kB 1.8 kB ✓
edge-ssr-HASH.js gzip 256 B 256 B ✓
head-HASH.js gzip 352 B 349 B ✓
hooks-HASH.js gzip 385 B 384 B ✓
image-HASH.js gzip 580 B 580 B ✓
index-HASH.js gzip 259 B 258 B ✓
link-HASH.js gzip 2.5 kB 2.51 kB ✓
routerDirect..HASH.js gzip 319 B 317 B ✓
script-HASH.js gzip 385 B 387 B ✓
withRouter-HASH.js gzip 316 B 315 B ✓
1afbb74e6ecf..834.css gzip 106 B 106 B ✓
Total 7.97 kB 7.96 kB ✅ -8 B

Server

Edge SSR
Canary PR Change
edge-ssr.js gzip 124 kB 124 kB ✓
page.js gzip 240 kB 239 kB ✓
Total 364 kB 363 kB ✅ -928 B
Middleware
Canary PR Change
middleware-b..fest.js gzip 654 B 650 B ✓
middleware-r..fest.js gzip 155 B 156 B ✓
middleware.js gzip 32.8 kB 32.8 kB ✓
edge-runtime..pack.js gzip 842 B 842 B ✓
Total 34.5 kB 34.4 kB ✅ -67 B
Build Details
Build Manifests
Canary PR Change
_buildManifest.js gzip 738 B 738 B ✓
Total 738 B 738 B ✓
Build Cache
Canary PR Change
0.pack gzip 3.63 MB 3.61 MB 🟢 20.4 kB (-1%)
index.pack gzip 99.4 kB 99.9 kB ✓
index.pack.old gzip 99.9 kB 97.8 kB 🟢 2.1 kB (-2%)
Total 3.83 MB 3.8 MB ✅ -22 kB

🔄 Shared (bundler-independent)

Runtimes
Canary PR Change
app-page-exp...dev.js gzip 303 kB 302 kB ✓
app-page-exp..prod.js gzip 158 kB 157 kB ✓
app-page-tur...dev.js gzip 303 kB 302 kB ✓
app-page-tur..prod.js gzip 158 kB 157 kB ✓
app-page-tur...dev.js gzip 299 kB 299 kB ✓
app-page-tur..prod.js gzip 156 kB 155 kB ✓
app-page.run...dev.js gzip 300 kB 299 kB ✓
app-page.run..prod.js gzip 156 kB 155 kB ✓
app-route-ex...dev.js gzip 68.7 kB 68.2 kB ✓
app-route-ex..prod.js gzip 47.5 kB 46.9 kB 🟢 629 B (-1%)
app-route-tu...dev.js gzip 68.7 kB 68.2 kB ✓
app-route-tu..prod.js gzip 47.6 kB 46.9 kB 🟢 630 B (-1%)
app-route-tu...dev.js gzip 68.3 kB 67.8 kB ✓
app-route-tu..prod.js gzip 47.3 kB 46.7 kB 🟢 631 B (-1%)
app-route.ru...dev.js gzip 68.3 kB 67.8 kB ✓
app-route.ru..prod.js gzip 47.3 kB 46.7 kB 🟢 630 B (-1%)
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 41.1 kB 41.1 kB ✓
pages-api-tu..prod.js gzip 31.2 kB 31.2 kB ✓
pages-api.ru...dev.js gzip 41 kB 41 kB ✓
pages-api.ru..prod.js gzip 31.2 kB 31.2 kB ✓
pages-turbo....dev.js gzip 50.8 kB 50.8 kB ✓
pages-turbo...prod.js gzip 38.2 kB 38.2 kB ✓
pages.runtim...dev.js gzip 50.7 kB 50.7 kB ✓
pages.runtim..prod.js gzip 38.2 kB 38.2 kB ✓
server.runti..prod.js gzip 62.2 kB 62 kB ✓
Total 2.68 MB 2.67 MB ✅ -11.2 kB
📝 Changed Files (17 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
  • 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 
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

server.runtime.prod.js

Diff too large to display

@wyattjoh wyattjoh marked this pull request as ready for review January 7, 2026 22:27
@vercel
Copy link
Contributor

vercel bot commented Jan 7, 2026 •
edited
Loading

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

@wyattjoh wyattjoh requested a review from gnoff January 7, 2026 22:28
@wyattjoh wyattjoh merged commit a85d888 into canary Jan 9, 2026
162 of 163 checks passed
@wyattjoh wyattjoh deleted the wyattjoh/remove-ppr-flag branch January 9, 2026 06:04
unstubbable added a commit that referenced this pull request Jan 12, 2026
@unstubbable
Revert "refactor: consolidate PPR into cacheComponents architecture (#…
3af894f 
…88243)"

This reverts commit a85d888.

PR #88243 introduced deploy test regressions in the following test
suites:

- `test/e2e/app-dir/segment-cache/prefetch-runtime/prefetch-runtime.test.ts`
- `test/e2e/app-dir/segment-cache/client-params/client-params.test.ts`
@unstubbable unstubbable mentioned this pull request Jan 12, 2026
Merged
unstubbable added a commit that referenced this pull request Jan 12, 2026
@unstubbable
Revert "refactor: consolidate PPR into cacheComponents architecture (#…
9c5e3da 
…88243)" (#88421)

This reverts commit a85d888.

PR #88243 introduced deploy test regressions in the following test
suites:

-
`test/e2e/app-dir/segment-cache/prefetch-runtime/prefetch-runtime.test.ts`
- `test/e2e/app-dir/segment-cache/client-params/client-params.test.ts`
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@gnoff gnoff gnoff approved these changes

Assignees

No one assigned

Labels

created-by: Next.js team PRs by the Next.js team. tests type: next

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

4 participants

@wyattjoh @nextjs-bot @gnoff