eoao/cloud-mail

★ 9,033JavaScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

Mindmap

mindmap
  root((Cloud Mail))
    What it does
      Self-hosted email
      Send and receive
      Near-zero cost
    Tech Stack
      Cloudflare Workers
      Vue 3 frontend
      D1 database
    Features
      Role-based access
      Telegram forwarding
      AI code extraction
    Infrastructure
      R2 file storage
      Resend for sending
      KV caching
    Audience
      Developers
      Self-hosters

mindmap root((Cloud Mail)) What it does Self-hosted email Send and receive Near-zero cost Tech Stack Cloudflare Workers Vue 3 frontend D1 database Features Role-based access Telegram forwarding AI code extraction Infrastructure R2 file storage Resend for sending KV caching Audience Developers Self-hosters

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Deploy a near-zero-cost email service on Cloudflare to create and manage multiple email addresses on your own domain

USE CASE 2

Build a multi-user email system with role-based access controls so different users can only reach the inboxes or features you allow

USE CASE 3

Forward incoming emails to a Telegram bot for real-time notifications without checking a webmail interface

USE CASE 4

Add AI-powered verification code extraction so incoming login codes are automatically surfaced from email content

Tech stack

JavaScriptVue 3Cloudflare WorkersHonoDrizzle ORMCloudflare D1Cloudflare R2Resend

Getting it running

Difficulty · moderate Time to first run · 1h+

Requires a Cloudflare account with Workers, D1, R2, and KV enabled, plus a Resend account for outgoing email delivery.

Free to use, modify, and distribute for any purpose including commercial use, as long as the copyright notice is kept (MIT license).

In plain English

Cloud Mail is a self-hosted email service you can deploy using Cloudflare's free-tier infrastructure. With a single domain name, you can create multiple email addresses, send and receive messages with attachments, and manage everything through a web interface. Because it runs on Cloudflare Workers rather than a traditional server, the ongoing hosting cost can be close to zero depending on usage volume. The README is primarily written in Chinese. The system handles outgoing mail via the Resend email service, including bulk sending, embedded images, and file attachments. Incoming email can be forwarded to a Telegram bot or to another email address. Received files are stored in Cloudflare R2 object storage. An AI-powered step using Workers AI automatically reads verification codes out of incoming emails. On the management side, there is an admin panel with role-based access controls that can restrict which features and resources users can reach. Usage charts built with ECharts visualize email volume and user growth over time. The web interface is responsive and adjusts to desktop and mobile browsers. A CAPTCHA challenge using Cloudflare Turnstile is included to prevent automated signups. The technical stack is Cloudflare-native throughout. The backend runs on Workers with the Hono web framework and uses Drizzle ORM against Cloudflare D1 as the database, with Cloudflare KV for caching. The frontend is Vue 3 with the Element Plus component library. An open API supports batch user creation and querying emails with multiple filter conditions. The project is MIT licensed and available on GitHub under the eoao/cloud-mail repository name, though the online demo and documentation links point to an external site.

Copy-paste prompts

Prompt 1

Help me deploy Cloud Mail on Cloudflare Workers using my own domain, walk me through the wrangler setup, D1 database creation, and R2 bucket configuration.

Prompt 2

I've set up Cloud Mail. Show me how to configure role-based access so one user can only send emails while another has full admin access.

Prompt 3

How do I connect Cloud Mail's incoming email forwarding to a Telegram bot so I get a Telegram message every time a new email arrives?

Prompt 4

Help me configure Resend as the outgoing email provider for Cloud Mail and test sending an email with a file attachment.

Open on GitHub → Explain another repo

← eoao on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.