TempMail V2 is a cutting-edge temporary email solution designed for privacy-conscious users. Generate disposable email addresses instantly to protect your primary inbox from spam, tracking, and unwanted communications. Built with modern web technologies, TempMail V2 offers a sleek, responsive interface with powerful features like real-time inbox updates, dark mode, and seamless email management.

• ⚡ Instant Email Generation: Create disposable emails with a single click

• ? Auto-Refresh Capability: Keep your inbox updated automatically at customizable intervals

• ? Advanced Search: Filter emails quickly by sender, subject, or content

• ? Light & Dark Themes: Choose your preferred visual experience with theme persistence

• ? Responsive Design: Seamless experience across desktop, tablet, and mobile devices

• ? Privacy Focused: No registration or personal information required

• ? Spam Protection: Keep your primary inbox clean from unwanted communications

• ? Attachment Support: View and download email attachments securely

• Frontend: HTML5, CSS3 with custom variables for theming, JavaScript (ES6 Modules)

• Icons & UI: Font Awesome 6.0, custom animations

• APIs: Guerrilla Mail API for email operations

• Storage: LocalStorage for user preferences and session management

Experience TempMail V2 in action:

• A modern web browser

• Optional: Node.js and NPM if using Live Server

1. Clone the repository

   git clone https://github.com/mehmetkahya0/temp-mail.git

2. Navigate to the project directory

   cd temp-mail

3. Launch with your preferred method:

   Option 1: Open index.html directly in your browser

   Option 2: Use a local development server

   If you have Node.js installed:

   # Install Live Server globallynpm install -g live-server# Start the serverlive-server

4. Access the application

   Open your browser and navigate to:

• http://127.0.0.1:8080 (if using Live Server)

• or directly via the file:// protocol if opening index.html

1. When you first load the application, a random email address is automatically generated

2. Click the "New Address" button to generate a different disposable email

3. Use the copy button to easily copy the email address to your clipboard

1. Click "Load Mail" to manually fetch new messages (or enable auto-refresh)

2. Use the search field to filter messages by sender, subject, or content

3. Click the eye icon on any email to view its complete contents

4. Remove unwanted emails with the trash icon

1. Toggle between light and dark mode using the switch in the top-right corner

2. Enable "Auto-refresh" and select your preferred interval (10s, 30s, or 1m)

3. Access privacy policy and important information via the footer links

temp-mail/
├── css/
│   └── style.css              # Main stylesheet with theming and responsive design
├── js/
│   ├── api.js                 # API interactions and email functionality
│   ├── config.js              # Configuration and constants
│   └── theme.js               # Theme switching functionality
├── images/
│   ├── banner.png             # Project banner image
│   ├── header.png             # Header image
│   └── temp-mail-icon.png     # Application icon
├── privacy/
│   ├── privacy.css            # Privacy page styling
│   └── privacy.html           # Privacy policy content
├── index.html                 # Main application entry point
├── manifest.json              # PWA manifest file
├── robots.txt                 # Search engine directives
├── sitemap.xml                # Site structure for search engines
├── LICENSE                    # MIT license with commercial restrictions
└── README.md                  # Project documentation

TempMail V2 uses a secure pseudorandom generation system to create unique email addresses. The system leverages the Guerrilla Mail API, ensuring high deliverability and compatibility with most services.

// Email generation example (simplified)const randomStr = Math.random().toString(36).substring(2, 8);const domain = CONFIG.DOMAINS[Math.floor(Math.random() * CONFIG.DOMAINS.length)];// Result: randomStr@domain

The application features a sophisticated theming system using CSS variables and JavaScript. User preferences are stored in localStorage for persistence across sessions:

// Theme switchingif (darkMode) {
    document.documentElement.setAttribute('data-theme', 'dark');
    localStorage.setItem('theme', 'dark');} else {
    document.documentElement.setAttribute('data-theme', 'light');
    localStorage.setItem('theme', 'light');}

The inbox system provides real-time updates, efficient search capabilities, and intuitive email management:

• Auto-refresh with configurable intervals

• Full-text search across all email fields

• Modal-based email viewing with attachment support

• One-click email deletion

TempMail V2 is highly customizable to suit your needs:

1. API Provider

• Modify CONFIG.API_BASE in js/config.js to use a different email API provider

2. Available Domains

• Edit the DOMAINS array in js/config.js to add or remove email domains

3. UI Theming

• Customize the look and feel by modifying CSS variables in css/style.css

4. Auto-Refresh Intervals

• Add or modify refresh intervals in the HTML select options and handle them in JavaScript

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/AmazingFeature)

3. Commit your Changes (git commit -m 'Add some AmazingFeature')

4. Push to the Branch (git push origin feature/AmazingFeature)

5. Open a Pull Request

See the open issues for a list of proposed features and known issues.

This project is licensed under the Special License with specific commercial restrictions - see the LICENSE file for details.

Important: While you can use this project for personal and educational purposes, commercial use requires explicit permission from the project author.

Mehmet Kahya

• Guerrilla Mail for their robust temporary email API

• Font Awesome for their comprehensive icon library

• All contributors who have helped improve this project