A modern web-based email client application built specifically for viewing and managing emails from TestMail.app. This application provides a clean, responsive interface to browse, filter, and read emails with real-time updates.
- 📧 View emails from TestMail.app API
- 🔍 Search and filter emails by tags
- 📱 Responsive design (mobile and desktop)
- 🎨 Modern UI with dark/light theme support
- 📄 Pagination support for large email lists
- 👀 HTML email rendering with safe sandboxing
Before running this project, make sure you have:
- Node.js (version 16 or higher)
- npm or yarn package manager
- A TestMail.app account with API access
- Clone the repository:
git clone <YOUR_GIT_URL>
cd <YOUR_PROJECT_NAME>- Install dependencies:
npm install- Start the development server:
npm run devThe application will be available at http://localhost:5173
To use this application, you'll need to configure your TestMail.app credentials:
- Open the application in your browser
- Click on the Settings icon
- Enter your TestMail.app API Key and Namespace
- Save the configuration
- View Emails: Browse your emails in the left sidebar
- Read Email: Click on any email to view its content
- Filter: Use the tag filter to narrow down emails
- Pagination: Navigate through multiple pages of emails
- Theme: Toggle between light and dark themes
This project is built with modern web technologies:
- React - Frontend framework
- TypeScript - Type safety and better development experience
- Vite - Fast build tool and development server
- Tailwind CSS - Utility-first CSS framework
- shadcn/ui - Modern UI component library
- Tanstack Query - Data fetching and state management
- React Router - Client-side routing
src/
├── components/ # Reusable UI components
├── hooks/ # Custom React hooks
├── lib/ # Utility functions and types
├── pages/ # Application pages
├── services/ # API service layers
└── utils/ # Helper utilities