Skip to content

[cdn-caching] Add PPR state (ppr_state) to the skill - #128

Merged
Melkeydev merged 1 commit into
mainfrom
shinapatel/skill-ppr-state
Jul 27, 2026
Merged

[cdn-caching] Add PPR state (ppr_state) to the skill#128
Melkeydev merged 1 commit into
mainfrom
shinapatel/skill-ppr-state

Conversation

@shinapatel

@shinapatel shinapatel commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

What

Adds ppr_state to the cdn-caching skill:

  • description + prompt signals (ppr state, ppr_state, x-vercel-ppr-state) + retrieval alias/entity

  • a PPR state concept table under Key concepts, right after the Cache reason table:

    ppr_state Shown as Meaning
    page Static Fully prerendered, no function for the body
    shell Partial Static shell from cache + a postponed hole the function resumes
    blocking Dynamic Empty shell, whole body rendered per request

    plus how to read it (vercel logs, dashboard Logs panel, vercel metrics --group-by ppr_state) and the internal-only x-vercel-ppr-state header note.

  • regenerated generated/ manifests.

Why

ppr_state is a per-request PPR field the proxy now emits (page/shell/blocking), surfaced in vc logs, the Logs panel, and vercel metrics. It belongs next to cacheReason in the CDN caching skill since PPR's static shell is served from the ISR cache.

Mirrors the cacheReason treatment: ppr_state in the description, prompt
signals (ppr state / ppr_state / x-vercel-ppr-state), retrieval alias +
entity, and a PPR state concept table (page/shell/blocking -> Static/
Partial/Dynamic) next to the cache-reason section. Regenerated manifests.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@shinapatel
shinapatel requested a review from mknichel July 24, 2026 23:05
@shinapatel
shinapatel enabled auto-merge (squash) July 24, 2026 23:44
@Melkeydev
Melkeydev disabled auto-merge July 27, 2026 15:44
@Melkeydev
Melkeydev merged commit b61a2c5 into main Jul 27, 2026
3 checks passed
@Melkeydev
Melkeydev deleted the shinapatel/skill-ppr-state branch July 27, 2026 15:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants