2025-06-22 19:48:34 -04:00
2025-06-22 18:19:36 -04:00
2025-06-22 18:19:36 -04:00
2025-03-10 06:30:09 +08:00
2025-03-10 06:24:37 +08:00
2025-06-22 19:48:34 -04:00
2025-06-22 18:19:36 -04:00
2025-06-22 19:48:34 -04:00
2025-06-22 19:48:34 -04:00
2025-06-22 19:48:34 -04:00

🚀 ZMAIL - 24-hour Temporary Email Service

English | 中文

If you find this project helpful, please consider giving it a ⭐️ Star ⭐️. Your support is greatly appreciated!

ZMAIL Logo

💌 Secure, Simple, Disposable Email Service

🌐 Live Demo • ✨ Features • 🚀 Deployment • 💻 Development • 🔧 Tech Stack


📹 Video Tutorial

📺 The complete video tutorial covers:

  1. Project introduction and feature demonstration
  2. Detailed steps for frontend deployment to Cloudflare Pages
  3. Detailed steps for backend deployment to Cloudflare Workers
  4. Configuring Cloudflare Email routing
  5. Setting up environment variables and database

👉 Click here to watch the full tutorial


✨ Features

✨ Instant Creation

Get a temporary email address instantly, no registration required

🔒 Privacy Protection

Protect your real email from spam and data leaks

⚡ Real-time Reception

Receive emails in real-time without refreshing the page

🌐 Global Availability

Built on Cloudflare's global edge network for fast access worldwide

🔄 Auto-refresh

Automatically check for new emails, never miss important messages

📱 Responsive Design

Perfect fit for all devices, from mobile to desktop


🚀 Quick Deployment

ZMAIL consists of two parts that need to be deployed separately, deploy the backend first, then the frontend:

⚙️ Deployment Steps

Deploy to Cloudflare Workers

Deploy to Cloudflare
  1. Click "Deploy to Cloudflare" button
  2. Follow the instructions on the page
    • Connect your GitHub account
    • Enter an application name
    • Enter a database name
  3. Advanced settings -> Build variables
    • VITE_API_BASE_URL: Your Worker API base URL (e.g., https://api.mdzz.uk)
    • VITE_EMAIL_DOMAIN: Your domain list, separated by ',' (e.g., mdzz.uk,zaunist.com)
  4. Click "Create and Deploy"
  5. Configure Cloudflare Email routing
    • Set up Email routing in the Cloudflare dashboard to forward emails to your Worker
    • If you want to configure multiple domain emails, set up email forwarding for each domain to the worker in the CloudFlare dashboard

💻 Local Development

🚀 Development

# install dependencies
pnpm install

# start frontend development server
pnpm dev:frontend

# start backend development server
pnpm dev:backend

⚙️ Deployment

# deploy
pnpm run deploy

🔧 Tech Stack

🎨 Frontend

  • React - UI library
  • TypeScript - Type-safe JavaScript
  • Tailwind CSS - Utility-first CSS framework
  • Vite - Modern frontend build tool

⚙️ Backend

  • Cloudflare Workers - Edge computing platform
  • Cloudflare D1 - Edge SQL database
  • Cloudflare Email Workers - Email processing service

👥 Contributing

Contributions via Pull Requests or Issues are welcome!

⭐ Support This Project

If this project has been helpful to you, or if you like it, please give it a Star ⭐️

Your support motivates me to make continuous improvements!

GitHub stars

📄 License

MIT License

S
Languages
TypeScript 96.2%
HTML 1.5%
JavaScript 1.2%
CSS 1.1%