Skip to content

MIGRATION.md

Latest commit

 

History

History
44 lines (34 loc) · 2.51 KB

MIGRATION.md

File metadata and controls

44 lines (34 loc) · 2.51 KB
Raw

Migration: apps/web Vercel → Cloudflare Workers (2026-08-02)

The apps/web Next.js app (the RouteDock site + dashboard) was moved off Vercel (Hobby account soft-blocked for exceeding function-invocation fair-use limits) onto Cloudflare Workers via the OpenNext adapter. It's dynamic (SSR / force-dynamic home page pulling live provider data), so it runs as a real Worker — requires the Workers Paid ($5/mo) plan.

Scope: only apps/web. The agent/, packages/, and contracts/ workspaces are unaffected.

Changes made

File Change Why
apps/web/open-next.config.ts New OpenNext Cloudflare adapter config.
apps/web/wrangler.jsonc New Workers config: main: .open-next/worker.js, nodejs_compat, assets binding. All 6 public NEXT_PUBLIC_* vars live here.
apps/web/components/landing/HeroCodeBlock.tsx Stopped calling Shiki at runtime; now renders a pre-highlighted HTML constant Cloudflare Workers disallow runtime WASM (Shiki's Oniguruma engine) and Shiki's hast serializer deps don't bundle under pnpm.
apps/web/components/landing/heroCodeHtml.ts New — pre-generated highlighted HTML Output of scripts/gen-hero-code.mjs.
apps/web/scripts/gen-hero-code.mjs New — regenerates the hero HTML with Shiki (run in Node) So the snippet can be re-highlighted if the code changes.
apps/web/app/opengraph-image.tsx Deleted @vercel/og also needs runtime WASM (blocked on Workers).
apps/web/package.json Added @opennextjs/cloudflare + wrangler devDeps, deploy/preview/gen:hero scripts Reproducible deploys.

Env

All 6 vars are public NEXT_PUBLIC_* (Supabase URL/anon, Stellar network/expert URL, provider A/B URLs) — no secrets. Pulled from Vercel into apps/web/.env.production.local (gitignored) for the build and mirrored into wrangler.jsonc vars for runtime.

Deploy

cd apps/web && npm run deploy      # = opennextjs-cloudflare build && deploy

Needs CLOUDFLARE_API_TOKEN in env.

Custom domains — COMPLETE

The site and provider Workers are attached to Cloudflare custom domains:

  • routedock.xyz and www.routedock.xyz → dashboard Worker
  • api-a.routedock.xyz → provider-a Worker
  • api-b.routedock.xyz → provider-b Worker

Deployments use wrangler deploy; provider secrets are supplied with wrangler secret bulk, never committed to wrangler.jsonc.