Deploy Cloudflare

Streamly ships a premade Cloudflare Workers path using OpenNext and Wrangler. This runs the full app (operator admin + viewer storefront + APIs) — not CDN-only static hosting. Production reference: https://streamly.watch via pnpm run deploy:cloudflare.

The repo wrangler.jsonc is wired for streamly.watch (routes and KV ids). Before your own production deploy, create your KV namespace, replace ids, and change routes/vars to your domain.

When to use this

Goal	Use
Match production / edge deploy	This guide
Simple Node VM / Docker	Deploy (Node)
Local Workers runtime	`pnpm run preview:cloudflare`

Requirements

Node.js 20+, pnpm, Cloudflare account
Same secrets as a normal deploy (Environment Variables)
Cloudflare KV (incremental cache), queues; R2 optional when enabled on the account

1 — Install

corepack enable
pnpm install --frozen-lockfile
pnpm exec wrangler login --use-keyring

Cloudflare-related files: wrangler.jsonc, open-next.config.ts, custom-worker.ts.

2 — Create Cloudflare resources (once)

# Incremental cache (required while R2 is disabled in wrangler.jsonc)
pnpm exec wrangler kv namespace create NEXT_INC_CACHE_KV
pnpm exec wrangler kv namespace create NEXT_INC_CACHE_KV --preview

pnpm exec wrangler queues create streamly-jobs
pnpm exec wrangler queues create streamly-jobs-dead

Paste the returned id / preview_id into wrangler.jsonc → kv_namespaces binding NEXT_INC_CACHE_KV.

3 — Personalize wrangler.jsonc

Setting	Action
`routes`	Your domain patterns + `zone_name`
Public URL vars / build env	Your `NEXT_PUBLIC_APP_URL`, `PLATFORM_HOST`, API base

export NEXT_PUBLIC_APP_URL=https://your.domain
export NEXT_PUBLIC_PLATFORM_HOST=your.domain
export NEXT_PUBLIC_STREAMLY_API_BASE=https://your.domain/api/v1

Tenant viewers use the platform host or {slug}.your-platform-host style subdomains — not customer-owned custom domains. See Domain.

4 — Secrets

pnpm exec wrangler secret put SUPABASE_SERVICE_ROLE_KEY
pnpm exec wrangler secret put TENANT_SECRETS_MASTER_KEY
pnpm exec wrangler secret put STREAMLY_CRON_SECRET
pnpm exec wrangler secret put STREAMLY_INITIAL_ADMIN_EMAIL
pnpm exec wrangler secret put STREAMLY_INITIAL_ADMIN_PASSWORD
pnpm exec wrangler secret put RESEND_API_KEY
# plus TMDB, STREAMLY_FROM_EMAIL, etc. as needed

Local preview: copy .dev.vars.example → .dev.vars (includes NEXTJS_ENV=development).

5 — Deploy

pnpm run typecheck   # recommended
pnpm run deploy:cloudflare

Preview: pnpm run preview:cloudflare. Also: pnpm run upload:cloudflare. Hourly Worker cron runs internal jobs including maintenance and smart_sync (catalog warm).

6 — After deploy

Check	Expect
Storefront `/`	Theme + branding load
`/admin/login`	Email + password
Payment webhooks	Stripe `/api/webhooks/stripe`, PayPal `/api/webhooks/paypal` if enabled
Legal pages	Bundled markdown (Workers-safe)

Troubleshooting

Issue	Fix
KV / binding errors	Create your namespace; replace ids in `wrangler.jsonc`
Wrong branding	Check `NEXT_PUBLIC_PLATFORM_HOST` and DNS `Host`
Auth cookies fail	HTTPS URL must match `NEXT_PUBLIC_APP_URL`

​When to use this

​Requirements

​1 — Install

​2 — Create Cloudflare resources (once)

​3 — Personalize wrangler.jsonc

​4 — Secrets

​5 — Deploy

​6 — After deploy

​Troubleshooting

​Related

When to use this

Requirements

1 — Install

2 — Create Cloudflare resources (once)

3 — Personalize wrangler.jsonc

4 — Secrets

5 — Deploy

6 — After deploy

Troubleshooting

Related