fix(cloudflare): prewarm KV through deployed Workers by james-elicx · Pull Request #3324 · cloudflare/vinext

james-elicx · 2026-09-18T13:50:40Z

Summary

route prerender selections through the staged Worker when CDN pre-warming is enabled
let runtime-backed adapters, including KV, populate themselves from real Worker requests
avoid the duplicate local prerender and Wrangler KV bulk upload during pre-warm deploys
preserve local prerender artifacts for static export and non-pre-warm deployments
give standalone KV origin responses the build identity and cache-status capabilities required for certified staged warmup
skip discovered routes that do not participate in origin-managed data caching while retaining strict Response Store admission checks
deploy the same cache demo with Workers Response Store, standalone KV, and Workers Cache + KV
run the same deployed pre-warming E2E against all three backends
prove data-cache population through a no-store route that invokes the same use-cache function, independent of the response-cache layer

vp test run tests/cache-adapters-config.test.ts tests/cdn-cache.test.ts tests/deploy-prerender-config.test.ts tests/cloudflare-cdn-warm.test.ts (134 tests)
vp check
vp run vinext#build
vp run @vinext/cloudflare#build
VINEXT_CACHE_BACKEND=kv VINEXT_KV_APP_PREFIX=local-e2e vp run response-store-demo#build
local standalone KV Worker: page response MISS then HIT, no Workers Cache entrypoint, build identity present, and no-store route reused the page cached-function UUID
VINEXT_CACHE_BACKEND=workers-cache VINEXT_KV_APP_PREFIX=local-workers-cache vp run response-store-demo#build
git diff --check

pkg-pr-new · 2026-09-18T13:51:41Z

@vinext/cloudflare

npm i https://pkg.pr.new/@vinext/cloudflare@3324

create-vinext-app

npm i https://pkg.pr.new/create-vinext-app@3324

@vinext/types

npm i https://pkg.pr.new/@vinext/types@3324

vinext

npm i https://pkg.pr.new/vinext@3324

@cloudflare/workers-response-store

npm i https://pkg.pr.new/@cloudflare/workers-response-store@3324

commit: 19d6097

github-actions · 2026-09-18T13:54:25Z

Example	Preview	Production	Original
app-router-cloudflare	preview	production
pages-router-cloudflare	preview	production
app-router-playground	preview	production	original
realworld-api-rest	preview	production
nextra-docs-template	preview	production
benchmarks	preview	production
hackernews	preview	production	original
response-store-demo	preview	production
workers-cache	preview	production
kv	preview	production
static-export	preview	production
web	preview	production

github-actions · 2026-09-18T13:55:06Z

Compared 19d6097 against base e97de29 using alternating same-runner rounds. Next.js was unchanged and skipped.

1 improved · 0 regressed · 5 within ±1.5%

Scenario	Framework	Baseline	Current	Change
Client bundle size (gzip)	vinext	142.2 KB	142.2 KB	⚫ +0.0%
Client entry size (gzip)	vinext	129.6 KB	129.6 KB	⚫ +0.0%
Dev server cold start	vinext	3.20 s	3.13 s	🟢 -2.1%
Production build time	vinext	3.63 s	3.60 s	⚫ -1.0%
RSC entry closure size (gzip)	vinext	121.0 KB	121.1 KB	⚫ +0.0%
Server bundle size (gzip)	vinext	218.3 KB	218.3 KB	⚫ +0.0%

_{🟢 improvement · 🔴 regression · ⚫ change below 1.5% · paired base/head}

james-elicx · 2026-09-20T21:18:27Z

/bigbonk review for issues