This project is a disposable email inbox service built to run entirely on Cloudflare's edge network. It creates temporary email addresses that automatically receive and store incoming messages and attachments, all without managing any traditional server infrastructure. The service uses Cloudflare Workers for serverless processing, Durable Objects for persistent inbox state, and Workers KV for storing email data, with attachments handled through R2 object storage.
The service distinguishes itself through a comprehensive set of access and management features. Users can authenticate through multiple methods including stored credentials, OAuth2 providers like GitHub and Authentik, or passwordless passkeys. An admin console provides centralized control for creating email addresses, managing users, configuring blacklists, and setting access passwords. The system also supports role-based permissions, CAPTCHA verification via Cloudflare Turnstile, and configurable rate limiting to prevent abuse.
Beyond basic email reception, the platform offers advanced email processing capabilities. Incoming emails are parsed using a Rust WebAssembly module for reliable content extraction, and an AI-powered feature can automatically identify verification codes and authentication links. Users can filter their inbox by address or keyword, forward emails to other addresses, and even send emails with DKIM signing support. The service also integrates with Telegram for notifications and a mini app interface, and can fire webhook events for external system integration.
The entire application is deployed through automated GitHub Actions workflows, with the frontend hosted as a static site on Cloudflare Pages and backend logic running on Workers. The repository includes configuration for automatic upstream synchronization, allowing forked instances to stay current with the latest changes.
