Cloudflare Workers

Holocron can be deployed to Cloudflare Workers for edge-rendered docs with global distribution.

Setup

Install wrangler and the Cloudflare Vite plugin:

1pnpm add -D wrangler @cloudflare/vite-plugin

Add the Cloudflare plugin after Holocron in vite.config.ts:

123456789101112131415import { cloudflare } from '@cloudflare/vite-plugin'
import { holocron } from '@holocron.so/vite'
import { defineConfig } from 'vite'

export default defineConfig({
  plugins: [
    holocron(),
    cloudflare({
      viteEnvironment: {
        name: 'rsc',
        childEnvironments: ['ssr'],
      },
    }),
  ],
})

Create a wrangler.json or wrangler.jsonc:

123456{
  "name": "my-docs",
  "main": "spiceflow/cloudflare-entrypoint",
  "compatibility_date": "2026-04-13",
  "compatibility_flags": ["nodejs_compat"]
}

Build and deploy

12npx vite build
npx wrangler deploy

Custom entry with Workers

If you use a custom entry, your Spiceflow app runs as the Worker entry point. You can add Cloudflare-specific bindings (KV, D1, AI) alongside your docs.

Example project

See the example-cloudflare/ directory in the Holocron repo for a minimal Cloudflare Workers deployment.