🔥 The Next-Generation Email Client - Reimagined for 2025
Built with cutting-edge technology and designed for the modern workflow
🚀 Quick Start • ✨ Features • 📖 Docs • 🤝 Contributing
Tired of clunky, outdated email clients? Aether Mail is here to revolutionize your email experience with:
- 🎯 Modern Design - Beautiful, intuitive interface that adapts to your workflow
- ⚡ Blazing Fast - Built with Rust backend and React frontend for optimal performance
- 🔒 Privacy-First - End-to-end encryption with PGP support
- 🌐 Universal Compatibility - Works with any email provider via IMAP/SMTP
- 📱 Cross-Platform - Desktop, mobile, and web versions available
- 🧩 Extensible - Plugin system for custom functionality
# Experience the future of email in 30 seconds
git clone https://github.com/skygenesisenterprise/aether-mail.git
cd aether-mail && pnpm install && pnpm devVisit http://localhost:4000 and transform your email workflow!
# Clone & Install
git clone https://github.com/skygenesisenterprise/aether-mail.git
cd aether-mail
pnpm install
# Configure & Launch
pnpm env:setup
pnpm dev🎉 That's it! Your modern email client is running at:
- Frontend: http://localhost:4000
- Backend API: http://localhost:3000
# Production-ready in seconds
docker-compose -f docker-compose.prod.yml up -d- Node.js 18+ ⚡
- pnpm 9.0+ 📦
- PostgreSQL 14+ 🗄️
- Rust 2021+ 🦀 (for backend development)
- Responsive Design - Perfect on mobile, tablet, and desktop
- Dark/Light/System Themes - Your eyes will thank you
- Compact & Comfortable Views - Choose your density
- Focus Mode - Distraction-free email composition
- Keyboard Shortcuts - Power user friendly
- Conversation View - Threaded emails (coming soon!)
- Advanced Search - Find anything instantly
- Smart Filters - Automatic email categorization
- Bulk Actions - Process hundreds of emails at once
- Custom Labels - Color-code your organization
- Email Templates - Reuse your best responses
- Quick Replies - One-click canned responses
- Schedule Sending - Send at the perfect time
- Read Receipts - Know when your emails are read
- Undo Send - Oops prevention (coming soon!)
- End-to-End Encryption - PGP/OpenPGP support
- Secure Authentication - Better Auth + JWT
- Session Management - Advanced security monitoring
- Content Security Policy - Enterprise-grade protection
- TypeScript Everywhere - Type-safe development
- Modern Stack - React 18 + Rust + PostgreSQL
- API-First Design - RESTful with OpenAPI docs
- Testing Suite - Comprehensive test coverage
- Docker Ready - Containerized deployment
- Virtual Scrolling - Handle 100k+ emails smoothly
- Lazy Loading - Instant UI, content on demand
- Smart Caching - Lightning-fast email access
- Code Splitting - Minimal bundle sizes
- Background Sync - Always up-to-date
| Platform | Status | Download |
|---|---|---|
| Web | ✅ Stable | Live Demo |
| Windows | 🔄 Beta | Download |
| macOS | 🔄 Beta | Download |
| Linux | 🔄 Beta | Download |
| Mobile | 📋 Planned | Q2 2025 |
// Modern React Stack
React 18.3 + TypeScript 5.9
├── 🎨 Tailwind CSS 3.4 + Radix UI
├── 🔄 Zustand 5.0 (State Management)
├── 🛣️ React Router 7.9
├── ⚡ Framer Motion (Animations)
├── 📚 Storybook 8.6 (Component Docs)
└── 🔧 Biome 2.2 (Linting/Formatting)// High-Performance Rust
Rust 2021 + Axum Framework
├── 🗄️ PostgreSQL + Prisma ORM
├── 🔐 Better Auth + JWT
├── 📧 IMAP/SMTP Services
├── 🛡️ Security Middleware
└── 📊 OpenAPI Documentation# Modern DevOps
Docker & Docker Compose
├── 🚀 CI/CD Pipeline
├── 📈 Performance Monitoring
├── 🔍 Security Scanning
├── 📊 Analytics Integration
└── ☁️ Cloud Deployment Ready# 🚀 Development
pnpm dev # Full stack development
pnpm dev:frontend # Frontend only (port 4000)
pnpm dev:backend # Backend only (port 3000)
# 🏗️ Building
pnpm build # Production build
pnpm build:frontend # Frontend build
pnpm build:backend # Backend build
# 🧪 Testing
pnpm test # All tests
pnpm test:coverage # With coverage report
pnpm test:e2e # End-to-end tests
# 🔧 Code Quality
pnpm lint # Lint and fix
pnpm format # Format code
pnpm typecheck # TypeScript checking
# 🐳 Docker
pnpm docker:dev # Development environment
pnpm docker:prod # Production environment
pnpm docker:build # Build images- ✅ TypeScript Strict Mode - Catch errors early
- 🎨 Biome Formatting - Consistent code style
- 📝 Conventional Commits - Clear git history
- 🧪 Test Coverage - Minimum 80% required
- 🔒 Security First - Automated security scans
- ✅ Core email functionality
- ✅ Modern UI/UX
- ✅ Security & encryption
- 🔄 In Progress: Conversation view
- 🔄 In Progress: Mobile optimization
- 📋 Email templates & quick replies
- 📅 Schedule sending
- 🔍 Advanced search & filters
- 📱 Mobile apps (iOS/Android)
- 🔄 Real-time sync
- 🤖 AI-powered email sorting
- 📝 Smart compose suggestions
- 📊 Email analytics
- 🔔 Intelligent notifications
- 🤝 Team collaboration
- 👥 Multi-tenant support
- 🔐 Advanced security features
- 📈 Admin dashboard
- 🔌 Plugin ecosystem
- ☁️ Cloud hosting solution
We believe in open collaboration and welcome contributions from everyone!
- 🍴 Fork the repository
- 🌿 Create a feature branch (
git checkout -b feature/amazing-feature) - 💻 Code your amazing feature
- 🧪 Test thoroughly (
pnpm test) - 📝 Commit with conventional commits
- 🚀 Push to your branch
- 🔄 Open a Pull Request
| Type | Description | Examples |
|---|---|---|
| 🐛 Bug Fixes | Fix reported issues | Memory leaks, UI bugs |
| ✨ Features | New functionality | Email templates, search |
| 📚 Docs | Improve documentation | API docs, guides |
| 🎨 UI/UX | Design improvements | Better layouts, animations |
| ⚡ Performance | Speed optimizations | Caching, lazy loading |
| 🔒 Security | Security enhancements | Encryption, validation |
- 🏅 Contributor Badge - Show off your work
- 📖 Early Access - Try features before release
- 🎯 Influence - Help shape product direction
- 🌟 Recognition - Featured in our README
- 📖 Documentation - Comprehensive guides
- 🐛 GitHub Issues - Bug reports
- 💡 Discussions - Feature requests
- 📧 Email Support - Direct help
- 💬 Discord Community - Chat with us
Found a bug? Please help us fix it:
- 🔍 Search existing issues first
- 📝 Create detailed issue with:
- Clear description
- Steps to reproduce
- Environment info
- Screenshots/logs
- 🏷️ Label appropriately
Have an idea? We'd love to hear it:
- 💭 Check if already requested
- 📋 Describe the problem you're solving
- 🎯 Explain the proposed solution
- 📈 Consider the impact and priority
| Metric | Value | Trend |
|---|---|---|
| ⭐ GitHub Stars |  |
📈 Growing |
| 🍴 Forks |  |
📈 Growing |
| 🐛 Issues | |
🔄 Active |
| 📝 Contributors |  |
📈 Growing |
| 📦 Downloads |  |
📈 Growing |
Special thanks to our amazing sponsors who make this project possible:
🤝 Become a sponsor and support open-source development!
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
Copyright 2025 Sky Genesis Enterprise
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
- 🚀 Sky Genesis Enterprise - Development & maintenance
- 👥 All Contributors - Amazing community support
- 📚 Open Source Community - Tools and libraries
- 🎨 Design Community - Inspiration and feedback
⭐ Star This Repo • 🚀 Try Live Demo • 📖 Read Documentation • 🐛 Report Issues
Made with ❤️ by the Sky Genesis Enterprise team
Building the future of email, one commit at a time
