Transform your email experience with intelligent organization, smart replies, and seamless calendar integration
Features β’ AI Capabilities β’ Getting Started β’ Tech Stack β’ Architecture β’ Contributing
LexiSort is a revolutionary AI-powered email platform that transforms how you manage, organize, and interact with your emails. Built with cutting-edge technology and designed for modern professionals, LexiSort combines intelligent automation with a beautiful, intuitive interface to make email management effortless.
- π€ AI-Powered Intelligence: Advanced machine learning for email categorization and smart replies
- π Privacy-First Design: End-to-end encryption with zero-knowledge architecture
- β‘ Lightning Fast: Optimized performance with real-time synchronization
- π¨ Beautiful Interface: Modern, responsive design built with Once UI
- π Seamless Integration: Works perfectly with your existing Gmail account
- π Smart Analytics: Gain insights into your email patterns and productivity
AI-powered inbox that automatically categorizes and prioritizes your emails:
- Automatic email categorization by type and importance
- Smart filtering to reduce inbox clutter
- Intelligent sorting based on sender and content
- Customizable organization rules
Generate contextually appropriate email replies with just one click:
- One-click smart reply generation
- Tone-matching responses
- Context-aware suggestions
- Professional formatting with proper etiquette
Advanced filtering system for better workflow management:
- Priority-based email filtering (Urgent, High, Medium, Low)
- Custom folder creation and management
- Smart categorization by email type
- Quick access to important communications
Organize emails into intelligent folders that adapt to your workflow:
- AI-suggested folder organization
- Automatic email routing
- Custom folder hierarchies
- Smart tagging and labeling
Seamlessly integrate your email with calendar events:
- Email-to-calendar event creation
- Meeting scheduling from emails
- Calendar event reminders
- Integrated time management
Transform email conversations into calendar events:
- Automatic date/time detection from emails
- One-click event creation
- Meeting participant management
- Event reminder integration
Personalize your email experience:
- Customizable interface themes
- Personalized email templates
- Adaptive learning preferences
- User-specific AI training
Get intelligent insights about your email patterns:
- Email pattern analysis
- AI behavior customization
- Communication style insights
- Productivity recommendations
Gain valuable insights into your email habits:
- Email response time analytics
- Communication pattern insights
- Productivity metrics
- Performance optimization suggestions
|
π Busy Professionals Focus on high-priority communications without drowning in your inbox |
π₯ Team Leaders Efficiently manage work communications with smart filters and AI organization |
|
π Privacy-Conscious Users Keep your email data secure with our privacy-first approach |
β‘ Gmail Power Users Take your Gmail experience to the next level with AI-powered features |
- Next.js 15.3.0 - React framework with App Router
- React 18.2.0 - UI library with hooks and concurrent features
- TypeScript 5.0 - Type-safe JavaScript development
- Once UI - Modern component library with design system
- TailwindCSS - Utility-first CSS framework
- Next.js API Routes - Serverless API endpoints
- Prisma ORM - Type-safe database client
- BetterAuth - Modern authentication solution
- Gmail API - Email integration and management
- PostgreSQL 15 - Primary relational database
- Redis - Caching and session management
- Qdrant Vector DB - Vector storage for AI embeddings
- Prisma Migrations - Database schema management
- OpenRouter API - LLM integration for smart features
- Vector Embeddings - Semantic search and similarity
- Email Categorization - AI-powered organization
- Smart Reply Generation - Context-aware responses
- Priority Detection - Intelligent email prioritization
- Docker Compose - Local development environment
- Environment Variables - Secure configuration management
- GitHub Actions - CI/CD pipeline (configurable)
LexiSort/
βββ src/
β βββ app/ # Next.js App Router
β β βββ (auth)/ # Authentication pages
β β β βββ login/ # Login interface
β β β βββ register/ # Registration interface
β β βββ (main)/ # Main application
β β β βββ inbox/ # Email inbox views
β β β βββ calendar/ # Calendar integration
β β β βββ contacts/ # Contact management
β β β βββ profile/ # User settings
β β βββ (dev)/ # Development tools
β β β βββ ai/ # AI processing utilities
β β βββ api/ # API routes
β β β βββ auth/ # Authentication endpoints
β β β βββ inbox/ # Email management
β β β βββ smart-reply/ # AI reply generation
β β β βββ sync/ # Background synchronization
β β βββ globals.css # Global styles
β βββ components/ # Reusable UI components
β β βββ Boxes/ # Layout components
β βββ libs/ # Core libraries
β β βββ auth/ # Authentication utilities
β β βββ db.ts # Database configuration
β β βββ env.ts # Environment variables
β β βββ utils/ # Utility functions
β βββ once-ui/ # Design system components
βββ prisma/ # Database schema
β βββ schema.prisma # Prisma schema definition
βββ public/ # Static assets
β βββ images/ # Images and logos
βββ docker-compose.yml # Development environment
- Node.js 18+ or Bun 1.0+
- Docker and Docker Compose
- Git
# Clone the repository
git clone https://github.com/your-username/lexisort.git
cd lexisort
# Start all services
docker compose up -d
# Install dependencies
bun install
# Set up environment variables
cp .env.example .env.local
# Run database migrations
bunx prisma db push
# Start development server
bun run dev# Clone the repository
git clone https://github.com/your-username/lexisort.git
cd lexisort
# Install dependencies
npm install
# Set up environment variables
cp .env.example .env.local
# Configure your environment variables
# (See Environment Variables section below)
# Set up the database
npx prisma db push
# Start development server
npm run devCreate a .env.local file with the following variables:
# Database
DATABASE_URL="postgresql://username:password@localhost:5432/lexisort"
# Redis
REDIS_URL="redis://localhost:6381"
# Authentication
NEXTAUTH_SECRET="your-secret-key"
NEXTAUTH_URL="http://localhost:3000"
# Gmail API
GOOGLE_CLIENT_ID="your-google-client-id"
GOOGLE_CLIENT_SECRET="your-google-client-secret"
# AI Services
OPENROUTER_API_KEY="your-openrouter-api-key"
# Vector Database
QDRANT_URL="http://localhost:6333"-
Create Google Cloud Project
- Go to Google Cloud Console
- Create a new project or select existing one
-
Enable Gmail API
- Navigate to APIs & Services β Library
- Search for "Gmail API" and enable it
-
Configure OAuth Consent Screen
- Go to APIs & Services β OAuth consent screen
- Set user type to "External"
- Add required scopes:
https://www.googleapis.com/auth/gmail.readonly https://www.googleapis.com/auth/gmail.modify
-
Create OAuth Credentials
- Go to APIs & Services β Credentials
- Create OAuth 2.0 Client ID
- Add authorized redirect URI:
http://localhost:3000/api/auth/callback/google
-
Update Environment Variables
- Add your client ID and secret to
.env.local
- Add your client ID and secret to
- Client-Side Encryption: All sensitive data encrypted before server storage
- User-Controlled Keys: Only you can decrypt your email content
- Data Isolation: Emails remain secure even in case of server breach
- Zero Server Access: Server never sees unencrypted email content
- β Email body content
- β Email subject lines
- β Email snippets and previews
- β Sender and recipient information
- β AI metadata and preferences
- GDPR - Data protection and privacy compliance
- CCPA - California consumer privacy compliance
- HIPAA - Healthcare data protection (with proper configuration)
- Background Syncing: Real-time email synchronization
- Intelligent Caching: Redis-based caching for fast responses
- Vector Search: Efficient semantic search with Qdrant
- Lazy Loading: On-demand component and data loading
- CDN Integration: Fast static asset delivery
- Performance Metrics: Response time and throughput monitoring
- Error Tracking: Comprehensive error logging and alerting
- User Analytics: Privacy-respecting usage analytics
- Health Checks: Automated system health monitoring
We welcome contributions from the community! Here's how you can help:
# Fork and clone the repository
git clone https://github.com/your-username/lexisort.git
cd lexisort
# Create a feature branch
git checkout -b feature/amazing-feature
# Install dependencies
npm install
# Start development environment
docker compose up -d
npm run dev
# Make your changes and test
npm run test
npm run lint
# Commit and push
git commit -m 'Add amazing feature'
git push origin feature/amazing-feature
# Create a Pull Request- Code Style: Follow TypeScript and ESLint guidelines
- Testing: Add tests for new features
- Documentation: Update docs for API changes
- Security: Follow security best practices
- Performance: Consider impact on performance
- π Bug Fixes: Help improve stability
- β¨ New Features: Add innovative capabilities
- π Documentation: Improve guides and examples
- π¨ UI/UX: Enhance user experience
- π§ DevOps: Improve deployment and monitoring
- π Internationalization: Add language support
This project is licensed under the MIT License - see the LICENSE file for details.
- Next.js Team - For the amazing React framework
- Prisma Team - For the excellent ORM
- OpenRouter - For AI capabilities
- Gmail API - For email integration








