Dispoflare

Disposable email addresses on the fly powered by Cloudflare

Features

• ➕ Generate new email addresses at any time (via Email Router)
  • 🔀 Random or user-defined username
• 📅 Handle expiration dates (via Cron Triggers)
  • ⏲️ Optional deprecation period (via Email Workers)
  • 🗃️ Optional archived period with possible remediation
  • 🗑️ Automatic clean up delay

About

Dispoflare is an app using Cloudflare products to host and manage disposable email addresses.

• Email routing: Cloudflare Email Routing
• Static hosting: Cloudflare Pages
• Backend functions: Cloudflare Workers
• Authentication: Cloudflare Access

Getting started

Requirements

Dispoflare is a full-stack app running on top of Cloudflare platform. We are of course assuming that you have:

• A Cloudflare account (click here if you don't)
• At least one zone using Cloudflare. If you don't have a zone, you can use Cloudflare Registrar.

All the used Cloudflare products offer a free plan that allows to try them for personal or hobby projects.

Deploy

Please pay attention to all the steps involved in the installation process.

• Authorize Workers to use your GitHub account.
• Enter your Account ID (from the previous section)
• Press the Create token button first, to create it, it will redirect you to a token template with all the required permissions pre-configured. Then enter the API token in the form.
• Fork the repository into your personal GitHub account.
• Enable GitHub Actions.
• Deploy.

Access Policy

Warning
Dispoflare has no user registration.

Dispoflare uses Zero Trust Access to handle user authentication. It assumes that your users will register with another identity provider (Zero Trust supports many providers or your custom one that implements Generic SAML 2.0).

Development & Contributions

Codespaces

This repository is ready for Development Containers. Click the badge above to create a codespace for this repository and start making and submitting changes.

Local

• Run npm i in your terminal to install all dependencies
• Run npm run start in your terminal to start a development server
• Open a browser tab at http://localhost:8787/ to see your worker in action

License

This project is licensed under MIT License.