https://github.com/yhkq1/tempmail
Ever shared your private e-mail address and got bombed with spam afterwards? With this tool you generate disposable e-mail addresses - you'll never have to worry about spam, bots, ads and stuff ever again!
https://github.com/yhkq1/tempmail
api email html5-css3 javascript mit-license
Last synced: 3 months ago
JSON representation
Ever shared your private e-mail address and got bombed with spam afterwards? With this tool you generate disposable e-mail addresses - you'll never have to worry about spam, bots, ads and stuff ever again!
- Host: GitHub
- URL: https://github.com/yhkq1/tempmail
- Owner: yhkq1
- License: mit
- Created: 2024-11-26T15:57:22.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-02-15T21:46:51.000Z (4 months ago)
- Last Synced: 2025-02-15T22:26:55.427Z (4 months ago)
- Topics: api, email, html5-css3, javascript, mit-license
- Language: HTML
- Homepage: https://yhkq1.github.io/tempmail/
- Size: 43.9 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Temp Mail
A web-based temporary email generator that allows users to create, manage, and view disposable email addresses. This service helps keep your real inbox clean from spam, advertising, and malicious activity by providing a temporary, anonymous email address.
## 🚀 Features
- **Temporary Email Address Generation**: Automatically generate a random disposable email address with a single click.
- **Email Inbox**: View incoming emails sent to your temporary address directly within the app.
- **Email Management**: Effortlessly copy, refresh, or change the email address for added convenience and flexibility.
- **Responsive Design**: Fully responsive, ensuring the app works seamlessly on both desktop and mobile devices.
- **Fullscreen Menu Options**: Access additional details about the app, the developer, and the version through an easy-to-navigate fullscreen menu.
## 🌐 Demo
Check out the live demo of the app here:
[Temp Mail Demo](https://yhkq1.github.io/tempmail/)
## 💻 Technologies Used
This project was built using the following technologies:
- **HTML5**: The basic building block of the app structure.
- **Tailwind CSS**: A utility-first CSS framework used to design the responsive UI.
- **Font Awesome**: Provides icons for buttons and features.
- **jQuery**: Simplifies DOM manipulation and API calls.
- **1SecMail API**: Used to generate temporary email addresses and fetch incoming emails.
## 🧑💻 How It Works
1. **Email Generation**: When you visit the app, a temporary email address is automatically generated for you.
2. **Email Management**: You can:
- **Copy** the email address to your clipboard for easy use.
- **Refresh** the inbox to check for new emails sent to your temporary address.
- **Generate** a new temporary email address at any time.
3. **Incoming Emails**: All emails sent to your temporary address will appear in the inbox table, allowing you to view them instantly.
4. **Fullscreen Menu**: The app includes a fullscreen menu that provides additional information such as:
- **About**: Learn more about Temp Mail.
- **Developer**: Information about the creator of the app.
- **Version**: Displays the current version of the app.
## 🏁 Installation and Setup
To run this project locally on your machine:
1. **Clone the repository**:
```bash
git clone https://github.com/yhkq1/tempmail.git
```
2. **Navigate to the project folder**:
```bash
cd tempmail
```
3. **Open the app**:
- Open the `index.html` file in your preferred web browser.
- Alternatively, you can deploy the project to a server to take full advantage of all the features, such as dynamic email generation and inbox management.
## 📜 License
This project is licensed under the **MIT License**. See the [LICENSE](LICENSE) file for more details.
## 🛠️ Developer
This project was created by **[Janis(@yhkq1)](https://github.com/yhkq1)**.
Follow me on GitHub for more exciting projects!
## 🤝 Contributing
Contributions are welcome! To contribute:
1. Fork the repository.
2. Create a new branch (`git checkout -b feature-branch`).
3. Make your changes and commit them (`git commit -am 'Add new feature'`).
4. Push to the branch (`git push origin feature-branch`).
5. Open a pull request.
For major changes, please open an issue first to discuss what you'd like to change or improve.