Partial Prerendering (PPR) adalah teknik rendering Next.js 16 yang
menggabungkan static shell hasil prerender saat build dengan konten dinamis
yang di-stream belakangan, dalam satu route yang sama. Shell statis dikirim
instan ke browser, lalu bagian dinamis menyusul lewat batas Suspense,
sehingga halaman terasa cepat tanpa kehilangan data real-time.

**Ringkasan cepat:**

1. PPR menggabungkan static shell hasil prerender saat build dengan konten dinamis yang di-stream belakangan, dalam satu route yang sama.
2. Sejak Next.js 16, PPR sudah stabil dan otomatis aktif lewat opsi `cacheComponents: true` di `next.config.ts`, menggantikan flag eksperimental `experimental.ppr` dan `experimental_ppr` per-route dari Next.js 14-15 yang sudah dihapus total.
3. Batas statis dan dinamis ditentukan lewat komponen `<Suspense>` React: semua di luar boundary diprerender jadi static shell, semua di dalamnya di-stream setelah shell terkirim.
4. `cacheComponents` mengaktifkan PPR sekaligus directive `use cache`, `cacheLife`, dan `cacheTag` secara bersamaan sebagai satu konfigurasi terpadu.
5. PPR beda dari streaming biasa (`loading.js` sejak Next.js 13) karena static shell-nya sudah diprerender di build time, bukan menunggu request masuk lebih dulu.

## Apa Itu Partial Prerendering di Next.js 16?

Sebelum PPR, sebuah route pada dasarnya harus memilih salah satu: statis
penuh (cepat tapi datanya bisa basi) atau dinamis penuh (data selalu segar
tapi setiap request menunggu server). PPR menghapus pilihan itu dengan
mencampur keduanya di level komponen dalam satu halaman yang sama.

<table>
  <thead>
    <tr>
      <th>Aspek</th>
      <th>Statis Penuh (SSG)</th>
      <th>Dinamis Penuh (SSR)</th>
      <th>Partial Prerendering (PPR)</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>Respons awal</td>
      <td>Instan, dikirim dari hasil build</td>
      <td>Menunggu server memproses tiap request</td>
      <td>Instan lewat static shell yang diprerender</td>
    </tr>
    <tr>
      <td>Kesegaran data</td>
      <td>Bisa basi, tetap sama sampai build berikutnya</td>
      <td>Selalu segar, digenerate ulang tiap request</td>
      <td>Segar untuk bagian dalam boundary Suspense, shell tetap statis</td>
    </tr>
    <tr>
      <td>Kapan render terjadi</td>
      <td>Sekali saat build</td>
      <td>Setiap kali ada request masuk</td>
      <td>Shell saat build, konten dinamis di-stream saat request</td>
    </tr>
    <tr>
      <td>Cara aktivasi di Next.js 16</td>
      <td>Default untuk route tanpa API request-time</td>
      <td>Otomatis untuk route yang pakai API request-time di luar Suspense</td>
      <td>Otomatis lewat <code>cacheComponents: true</code> di next.config.ts</td>
    </tr>
  </tbody>
</table>

Menurut [glosarium resmi Next.js](https://nextjs.org/docs/app/glossary#partial-prerendering-ppr):

> A rendering optimization that combines prerendering and dynamic rendering
> in a single route. The static shell is served immediately while dynamic
> content streams in when ready, providing the best of both rendering
> strategies.
>
> — [Next.js Glossary, definisi Partial Prerendering (PPR)](https://nextjs.org/docs/app/glossary#partial-prerendering-ppr)

Bagian yang diprerender disebut **static shell**: struktur HTML yang sudah
lengkap berisi semua konten statis ditambah fallback dari boundary Suspense
untuk bagian yang belum siap.

Blog Vercel yang mengumumkan PPR pertama kali menjelaskan posisinya
dibandingkan dua model rendering yang sudah ada:

> PPR offers a unified model that blends the reliability and speed of
> Incremental Static Regeneration (ISR) and the dynamic capabilities of
> Server-Side Rendering (SSR).
>
> — Sebastian Markbåge & Malte Ubl, [Partial Prerendering, Vercel Blog](https://vercel.com/blog/partial-prerendering-with-next-js-creating-a-new-default-rendering-model)

### Kenapa Ini Beda dari Streaming Biasa?

Streaming lewat `loading.js` sudah ada sejak Next.js 13, tapi seluruh
halaman baru mulai dikirim setelah request masuk. PPR mengirim static
shell yang sudah diprerender di build time terlebih dulu, jadi bagian
statis muncul instan tanpa menunggu server memproses apa pun, baru
kemudian bagian dinamis di-stream menyusul di dalam boundary yang sama.

## Bagaimana Cara Kerja PPR Setelah Next.js 16?

PPR tidak lagi jadi flag terpisah yang harus diaktifkan sendiri. Sesuai
[dokumentasi resmi opsi `cacheComponents`](https://nextjs.org/docs/app/api-reference/config/next-config-js/cacheComponents),
mengaktifkan `cacheComponents: true` di `next.config.ts` otomatis membuat
PPR jadi perilaku default App Router:

```ts filename="next.config.ts"
import type { NextConfig } from "next";

const nextConfig: NextConfig = {
  cacheComponents: true,
};

export default nextConfig;
```

Flag `experimental.ppr` di level konfigurasi dan `experimental_ppr` di
level route segment yang dipakai eksperimen sejak Next.js 14-15 sudah
dihapus total di Next.js 16, digantikan satu opsi `cacheComponents` yang
mengatur PPR, `use cache`, dan `dynamicIO` sekaligus sebagai satu
konfigurasi terpadu. Artikel [Cache Components Next.js 16](/blog/cache-components-nextjs-16-panduan-lengkap)
di blog ini membahas lebih dalam soal directive `use cache`, `cacheLife`,
dan `cacheTag` yang jadi pasangan kerja PPR untuk mengatur bagian mana
yang di-cache dan berapa lama.

### Menandai Batas Statis dan Dinamis

Batas antara static shell dan konten yang di-stream ditentukan lewat
komponen `<Suspense>` bawaan React:

```tsx
import { Suspense } from "react";

export default function Page() {
  return (
    <main>
      <StaticHeader />
      <Suspense fallback={<ProductSkeleton />}>
        <DynamicProductList />
      </Suspense>
    </main>
  );
}
```

`StaticHeader` diprerender jadi bagian static shell karena tidak memakai
API request-time apa pun. `DynamicProductList` yang membaca `cookies()`,
`headers()`, atau `searchParams` otomatis opt-in ke dynamic rendering,
tapi karena dibungkus `<Suspense>`, fallback-nya (`ProductSkeleton`) ikut
masuk static shell, sementara konten aslinya di-stream begitu selesai
dirender di server.

## Ringkasan: Suspense Menentukan Batas, cacheComponents Mengaktifkannya Secara Stabil

- PPR menggabungkan static shell hasil prerender dengan konten dinamis
  yang di-stream, dalam satu route, lewat batas `<Suspense>`.
- Sejak Next.js 16, PPR sudah stabil dan otomatis aktif lewat opsi
  `cacheComponents: true`, menggantikan flag eksperimental `ppr` di
  Next.js 14-15.
- PPR bekerja berpasangan dengan directive `use cache` (dibahas lengkap
  di [Cache Components Next.js 16](/blog/cache-components-nextjs-16-panduan-lengkap)):
  PPR menentukan batas statis/dinamis, `use cache` menentukan cache data
  di dalamnya.
- Kalau proyekmu masih di Next.js 15 dan ingin migrasi untuk memakai PPR
  stabil ini, tim [layanan web development](/layanan) bisa membantu audit
  dan eksekusi upgrade-nya.