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, KV ids, and often ENABLE_DEMO=true). Before your own production deploy, create your KV namespace, replace ids, change routes/vars to your domain, and turn off demo mode.

When to use this

Goal	Use
Match production / edge deploy	This guide
Simple Node VM	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 (replace the Streamly account values). Optional when R2 is available: create the cache/media buckets noted in product DEPLOYMENT.md, then re-enable R2 bindings.

3 — Personalize wrangler.jsonc

Setting	Action
`routes`	Your domain patterns + `zone_name` (not `streamly.watch` unless that is yours)
`vars.NEXT_PUBLIC_*` / build env	Your public URL, platform host, API base
`vars.ENABLE_DEMO`	Set `"false"` (or remove) on real buyer installs
Worker `name` / self-reference service	Keep consistent if you rename the worker

pnpm run deploy:cloudflare currently bakes https://streamly.watch public URLs in package.json scripts — for your domain, set those env vars in the shell before deploy or adjust the scripts:

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

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 ENVATO_PERSONAL_TOKEN
pnpm exec wrangler secret put RESEND_API_KEY
# plus TMDB, STREAMLY_FROM_EMAIL, Cloudflare SaaS tokens, etc. as needed

Local Workers preview uses .dev.vars (from .dev.vars.example, includes NEXTJS_ENV=development) — never commit it.

5 — Deploy

pnpm run typecheck   # recommended
pnpm run deploy:cloudflare

What it runs: OpenNext Cloudflare build → worker minify → opennextjs-cloudflare deploy -- --minify. Preview:

pnpm run preview:cloudflare

Also available: pnpm run upload:cloudflare (build + upload without full deploy flow).

6 — Domains & SaaS

Attach your custom domain in Cloudflare → Workers & Pages → Domains & Routes. Optional Cloudflare for SaaS hostname automation:

CLOUDFLARE_ACCOUNT_ID
CLOUDFLARE_ZONE_ID
CLOUDFLARE_CUSTOM_HOSTNAMES_API_TOKEN
CLOUDFLARE_SAAS_FALLBACK_HOST (default customers.streamly.watch)

7 — After deploy

Check	Expect
Storefront `/`	Theme + branding load
`/admin/login`	Operator activation (Resend magic-link in production)
Stripe webhook	`https://your.host/api/webhooks/stripe`
Legal pages	Terms/privacy render (bundled markdown — Workers-safe)
Demo flags	Off on production

Do not rely on runtime fs reads for content under content/ on Workers. Legal markdown is imported at build time via lib/landing/legal-markdown.ts.

Troubleshooting

Issue	Fix
KV / binding errors	Create your namespace; replace ids in `wrangler.jsonc`
Wrong tenant / branding	Check `NEXT_PUBLIC_PLATFORM_HOST` and DNS `Host`
Auth cookies fail	Confirm HTTPS URL matches `NEXT_PUBLIC_APP_URL`
Demo license still showing	Set `ENABLE_DEMO` false in wrangler vars + secrets
Preview env missing	Copy `.dev.vars.example` → `.dev.vars`
Worker size limit	Ensure deploy uses `--minify` (default in `deploy:cloudflare`)

​When to use this

​Requirements

​1 — Install

​2 — Create Cloudflare resources (once)

​3 — Personalize wrangler.jsonc

​4 — Secrets

​5 — Deploy

​6 — Domains & SaaS

​7 — 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 — Domains & SaaS

7 — After deploy

Troubleshooting

Related