Summary
Add Cloudflare Workers (via Wrangler) as a deployment target, generating a wrangler.toml, Worker entry point, and CI deploy workflow.
Why
Cloudflare Workers is the leading edge deployment platform and pairs naturally with:
- Hono (
backend-hono)
- Remix (
frontend-remix)
- PlanetScale / Neon (serverless databases)
It’s the most-requested deployment target not currently in Foundation CLI.
Files to generate
wrangler.toml — Worker config (name, compatibility date, routes)
src/worker.ts — Worker entry point (export default { fetch })
.dev.vars.example — Cloudflare equivalent of .env.example for local dev
.github/workflows/deploy.yml — Wrangler GitHub Action for main branch deploys
Implementation hints
Contributor guidance
Refer to CONTRIBUTING.md → "Adding a New Module"
Acceptance criteria
Summary
Add Cloudflare Workers (via Wrangler) as a deployment target, generating a
wrangler.toml, Worker entry point, and CI deploy workflow.Why
Cloudflare Workers is the leading edge deployment platform and pairs naturally with:
backend-hono)frontend-remix)It’s the most-requested deployment target not currently in Foundation CLI.
Files to generate
wrangler.toml— Worker config (name, compatibility date, routes)src/worker.ts— Worker entry point (export default { fetch }).dev.vars.example— Cloudflare equivalent of.env.examplefor local dev.github/workflows/deploy.yml— Wrangler GitHub Action formainbranch deploysImplementation hints
Key dependency (dev):
wranglerWhen
backend-honois selected:src/worker.tsshould mount the Hono app directly (app.fetch)onAfterTemplatehook inspectingselectedModulesWhen
backend-expressis selected:package.jsonpatches:"deploy": "wrangler deploy""dev": "wrangler dev"Conflicts with:
deployment-dockerdeployment-verceldeployment-renderdeployment-awsContributor guidance
Refer to CONTRIBUTING.md → "Adding a New Module"
Acceptance criteria
foundation createlists Cloudflare Workers as a deployment optionwrangler.tomlis valid and passeswrangler deploy --dry-runmain