ni-mail/CLOUDFLARE_BUILDS.md

Cloudflare Builds Checklist

This project deploys in source-first mode.

• Worker name: ni-mail
• Wrangler entrypoint: src/index.ts
• Compatibility passthrough: worker.js
• Deploy command: npm run deploy
• Build command: leave empty
• Root directory: repository root (/ or blank)

If you upload files manually to GitHub, include the entire src/ folder. The deployment will fail if wrangler.jsonc is present but src/index.ts is missing from the repository snapshot.

Required dashboard settings

In Cloudflare Dashboard for Worker ni-mail:

1. Open Settings -> Builds.
2. Confirm the connected GitHub repository is this project.
3. Confirm the production branch is the branch that already contains src/index.ts and the current wrangler.jsonc.
4. Set Root directory to / or leave it blank.
5. Leave Build command empty.
6. Set Deploy command to npm run deploy.
7. Save the settings.
8. Retry the failed build.

Local verification

Run these commands from the repository root:

npm clean-install --progress=false
npm run check:deploy

Expected result:

• Wrangler resolves src/index.ts
• Wrangler detects the MAILBOX Durable Object binding
• Wrangler detects the BUCKET R2 binding

After a local npm run dev or a production deploy, run:

BASE_URL=https://<your-worker-or-domain> AUTH_KEY=<your-key> MAILBOX=hello@example.com npm run smoke

Mailbox reads may return 404 until mail arrives.

If Git Builds still says src/index.ts is missing

Treat that as a stale or misbound Cloudflare Builds source configuration.

1. Disconnect the GitHub repository from Worker ni-mail.
2. Reconnect the same repository.
3. Re-select the correct production branch.
4. Re-apply the settings above.
5. Trigger a fresh build with a new commit or a manual retry.

Smoke test after deploy

curl https://<your-worker>/health

Expected response:

{ "ok": true, "service": "ni-mail" }