Context: Why Edge Email Routing Still Breaks
When evaluating maillab/cloud-mail for a multi-tenant email forwarding service, the initial appeal was obvious: pure Cloudflare Workers runtime, zero persistent infrastructure, and claimed sub-50ms cold starts. The reality after three weeks of load testing revealed hard boundaries that the documentation glosses over.
This article dissects the operational failure modes we encountered when integrating maillab/cloud-mail into an existing SaaS pipeline handling ~200K inbound emails/day across 12 regional edge nodes.
Architecture Overview: What maillab/cloud-mail Actually Does
The repo implements a complete email service stack using Cloudflare's Email Routing API + Workers KV for state:
Inbound Flow : Email Workers intercept SMTP traffic, parse headers, apply routing rules stored in KV, then forward via fetch() to destination mailboxes.
Admin API : Hono.js router managing CRUD operations for aliases, forwarding rules, and webhook subscriptions.
Authentication…