Skip to content

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

Open
shinapatel wants to merge 1 commit into
mainfrom
shinapatel/skill-ppr-state
Open

[cdn-caching] Add PPR state (ppr_state) to the skill#128
shinapatel wants to merge 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
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.

2 participants