@avedon/adapter-cloudflare

Cloudflare Workers adapter for avedon. Emits a Wrangler-deployable build/ directory: static assets + SSG HTML, SSR Worker entry, and wrangler.jsonc. Optional KV-backed ISR when any route sets revalidate.

Config

import { cloudflareAdapter } from '@avedon/adapter-cloudflare'

export default {
  adapter: cloudflareAdapter({
    out: 'build',
    name: 'my-avedon-app',
    // isrKvBinding: 'AVEDON_ISR', // default
  }),
}

Build and deploy

pnpm build          # avedon build → build/
cd build && wrangler deploy

Requires Wrangler 4+ and a Cloudflare account.

Sessions

Set the Worker secret:

wrangler secret put SESSION_SECRET

If server-entry exports session without secret, the generated Worker fills secret from env.SESSION_SECRET.

ISR (optional)

When any route has revalidate, adapt emits:

• kv_namespaces with binding AVEDON_ISR (or isrKvBinding) and placeholder id <REPLACE_WITH_KV_NAMESPACE_ID> — replace with a real namespace id before deploy (wrangler kv namespace create …)
• assets.run_worker_first for ISR pathnames + POST /__avedon/revalidate so the Worker can intercept SSG HTML before Assets
• Worker SWR: KV keys html:{path}, meta:{path}, tags:{tag}; seed from ASSETS; background regen via ctx.waitUntil + renderSsgPage
• SSG GET fallback: if ISR miss, Worker still serves matching render: 'ssg' HTML from ASSETS before createHandler

On-demand:

curl -X POST https://your-worker/__avedon/revalidate \
  -H 'content-type: application/json' \
  -d '{"path":"/stats"}'
# or {"tag":"stats"}

Helpers revalidatePath / revalidateTag are also exported for custom handlers (pass { kv: env.AVEDON_ISR, routes, appHtml, assets: env.ASSETS }).

Without revalidate routes, behavior stays asset-first with no KV binding.

Dogfood (2026-08-09)

Live Worker avedon-isr-dogfood on account e3714019… with KV avedon-isr-dogfood (6ac88486…):

1. avedon build with cloudflareAdapter({ name: 'avedon-isr-dogfood' })
2. Replace placeholder KV id in build/wrangler.jsonc
3. wrangler deploy --config /abs/path/to/build/wrangler.jsonc (pass an absolute --config; pnpm exec wrangler from a nested cwd can resolve the wrong path)
4. Verified: GET /isr-lab/ serves SSG HTML; POST /__avedon/revalidate with {"tag":"isr-lab"} regenerates (builtAt advances)

Notes

• Targets Workers + Assets, not Pages Functions.
• Paths never built at avedon build are not created on revalidate (same as Node/Bun).