Skip to content

Commit

Permalink
feat: update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
shubhexists authored Dec 30, 2024
1 parent 38e94f5 commit ce13055
Showing 1 changed file with 71 additions and 16 deletions.
87 changes: 71 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,30 +1,85 @@
# FLUX-MAIL
# FLUX-MAIL 🦀

A self-hosted Temp Mail service written in Rust 🦀.
A self-hosted Temporary Email Service written in Rust. Create disposable email addresses instantly for your temporary needs.

To use the hosted version - [https://flux-mail.shubh.sh](https://flux-mail.shubh.sh)
<div align="center">

:accessibility: SMTP SERVER HOSTED AT -> flux.shubh.sh
[![GitHub stars](https://img.shields.io/github/stars/shubhexists/flux-mail?style=social)](https://github.com/shubhexists/flux-mail/stargazers)
[![Crates.io](https://img.shields.io/crates/v/flux-mail)](https://crates.io/crates/flux-mail)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

Any mails to "something"@flux.shubh.sh will be handled by the deployed SMTP server.
[View Demo](https://flux-mail.shubh.sh)[Report Bug](https://github.com/shubhexists/flux-mail/issues)[Request Feature](https://github.com/shubhexists/flux-mail/issues)

### Steps -
1) Go to the website and enter any username. Remember your `username` is public, so "DO NOT" use it for confidential mails.
2) You'll get the email of the form `{username}@flux.shubh.sh`. Use it for anything you want :)
3) ATTACHMENTS are not shown in the hosted version.
</div>

## 🌟 Features

![image](https://github.com/user-attachments/assets/d4a63fac-c3d1-4e33-a072-4e8003389e23)
- **Instant Setup**: Create temporary email addresses in seconds
- **No Registration**: Zero signup required
- **Self-Hostable**: Run your own instance easily
- **Rust-Powered**: Built with performance and reliability in mind
- **Simple Interface**: Clean and intuitive user experience

## Library Usage
To run your own version of Flux Mail on localhost, use the library published on [Crates.io](https://crates.io/crates/flux-mail)
## 📧 SMTP Server Details

```
- **Server Address:** `flux.shubh.sh`
- **Email Format:** `[email protected]`
- All emails sent to `{username}@flux.shubh.sh` will be automatically handled

## 🚀 Quick Start

1. Visit [flux-mail.shubh.sh](https://flux-mail.shubh.sh)
2. Choose your username
> ⚠️ **Security Note:** Your username is public. Do not use it for confidential communications.
3. Start using your temporary email: `{username}@flux.shubh.sh`

## 📸 Screenshot

![Flux Mail Interface](https://github.com/user-attachments/assets/d4a63fac-c3d1-4e33-a072-4e8003389e23)

## 💻 Installation

### Using as a Library

Add Flux Mail to your Rust project:

```bash
cargo add flux-mail
```

Refer to [main.rs](https://github.com/shubhexists/flux-mail/blob/master/src/main.rs) for usage of the library.
2. Check [main.rs](https://github.com/shubhexists/flux-mail/blob/master/src/main.rs) for implementation details

## ⚠️ Limitations

- Attachments are not displayed in the hosted version.
- Email will be removed after 7 days from the database.

## 🤝 Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.

1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/feature_name`)
3. Commit your Changes (`git commit -m 'feature_name'`)
4. Push to the Branch (`git push origin feature/feature_name`)
5. Open a Pull Request

## 📜 License

Distributed under the MIT License. See `LICENSE` for more information.

## 🌟 Show your support

Give a ⭐️ if this project helped you!

## 📞 Contact

Shubham - [@shubhexists](https://github.com/shubhexists)

Project Link: [https://github.com/shubhexists/flux-mail](https://github.com/shubhexists/flux-mail)

### Thanks
---

Do star (⭐) the project if you like it.
<div align="center">
Made with ❤️ using Rust
</div>

0 comments on commit ce13055

Please sign in to comment.