🚀 MailMind AI - Email Marketing Campaign Analyzer
Analyze, Optimize, and Supercharge Your Email Marketing Performance with AI
A modern, full-stack application that transforms your email campaign data into actionable insights using artificial intelligence. Get personalized recommendations, performance predictions, and beautiful visualizations to take your email marketing to the next level.
🌟 Live Demo
🔗 Try MailMind AI Now
Experience the full application with:
- Interactive email emoji loading animations
- AI-powered campaign analysis
- Real-time performance predictions
- Beautiful QuillBot-inspired design
✨ Features
🎨 Amazing User Experience
- Interactive Loading Animations: Beautiful email emoji orbital animations during AI analysis
- QuillBot-Inspired Design: Clean, professional interface with smooth transitions and modern aesthetics
- Responsive Layout: Perfect experience on desktop, tablet, and mobile devices
- Intuitive Interface: User-friendly forms and campaign result displays
🤖 AI-Powered Intelligence
- Smart Campaign Analysis: AI identifies performance bottlenecks and optimization opportunities
- Personalized Recommendations: Tailored suggestions for improving open rates, click-through rates, and conversions
- ML Performance Predictions: Machine learning models forecast potential improvements
- Contextual Insights: Analysis considers campaign type, target audience, and industry best practices
📊 Comprehensive Analytics
- Performance Metrics: Detailed analysis of open rates, click-through rates, and conversion tracking
- Improvement Areas: Specific weak spots identification with actionable solutions
- Predicted Outcomes: Forecasted performance improvements with confidence levels
- Campaign History: Save and compare multiple campaign analyses
🏗️ Technology Stack
mailmind-ai/
├── 🎨 frontend/ # React TypeScript Application
│ ├── src/
│ │ ├── components/
│ │ │ ├── Hero/ # Landing page with campaign input form
│ │ │ ├── LoadingAnimation/ # Email emoji orbital animations
│ │ │ ├── CampaignModal/ # AI analysis results display
│ │ │ ├── Description/ # QuillBot-inspired process explanation
│ │ │ └── CampaignsGrid/ # Historical campaigns view
│ │ └── App.tsx # Main application logic and state
│ └── package.json
├── 🔧 api/ # Flask Python API
│ ├── index.py # API endpoints (health, analyze, campaigns)
│ └── requirements.txt # Python dependencies
├── 🚀 vercel.json # Full-stack deployment configuration
└── 📚 README.md
Frontend: React 18, TypeScript, CSS3 Animations
Backend: Flask, Python 3.9+
Deployment: Vercel (Frontend + Serverless Functions)
AI Integration: Ready for OpenAI GPT-4 integration
🚀 Quick Start
Prerequisites
- Node.js 16+ and npm
- Python 3.8+
- OpenAI API Key (Get one here)
1️⃣ Clone & Setup
git clone https://github.com/AceAtDev/MailMindAI.git
Backend Setup
cd backend
pip install -r requirements.txt
python main.py # This will spin off the backend
Local Development
Clone and Install:
# Frontend setup
cd frontend
npm install
npm start
Environment Setup:
# Optional: Add OpenAI API key for enhanced AI features
# Create .env file in project root
echo "OPENAI_API_KEY=your_key_here" > .env
Run Locally:
# Development server (frontend only)
cd frontend
npm start
# Full-stack development
vercel dev
Access Points:
🚀 Deployment
This application is deployed on Vercel with both frontend and backend:
Live Application: https://mailmindai-eta.vercel.app
API Endpoints:
GET /api/ - API status and health check
GET /api/campaigns - Retrieve saved campaign analyses
POST /api/analyze-campaign - Analyze new campaign data
Deploy Your Own:
# Deploy to Vercel
npm i -g vercel
vercel
# Or deploy to your preferred platform
# The app is configured for easy deployment anywhere
� How It Works
1. Input Campaign Data
Enter your email campaign metrics including:
- Campaign name and basic info
- Emails sent, open rates, click rates
- Conversion rates and revenue data
2. AI Analysis Magic ✨
Watch the beautiful loading animation while our AI:
- Analyzes your performance data
- Compares against industry benchmarks
- Identifies improvement opportunities
- Generates personalized recommendations
3. Get Actionable Insights
Receive a comprehensive report with:
- Performance Overview: Clear metrics visualization
- Improvement Areas: Specific bottlenecks identified
- AI Recommendations: Detailed optimization strategies
- ML Predictions: Forecasted performance improvements
🚀 Deployment
Vercel (Recommended)
This project is pre-configured for Vercel deployment:
# Install Vercel CLI
npm i -g vercel
# Deploy
vercel
# Set environment variables in Vercel dashboard:
# OPENAI_API_KEY=your_openai_api_key
Manual Deployment
- Frontend: Build with
npm run build and serve static files
- Backend: Deploy FastAPI app to any Python hosting service
- Environment: Ensure
OPENAI_API_KEY is set in production
🛠️ Development
Project Dependencies
Backend (Python)
fastapi==0.104.1 - Modern API framework
uvicorn - ASGI server
openai - OpenAI API integration
pandas - Data analysis
sqlalchemy - Database ORM
python-dotenv - Environment management
Frontend (React)
react^19.1.1 - Modern React with hooks
typescript^4.9.5 - Type safety
react-markdown - Markdown rendering
API Endpoints
POST /analyze - Submit campaign data for analysis
GET /campaigns - Retrieve historical campaigns
GET /health - Health check endpoint
GET /docs - Interactive API documentation
🔒 Security & Privacy
- ✅ API Keys Protected: Environment variables kept secure
- ✅ No Data Storage: Campaign data processed in memory only
- ✅ CORS Configured: Secure cross-origin requests
- ✅ Input Validation: Pydantic models ensure data integrity
🤝 Contributing
We welcome contributions! Please:
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature
- Commit changes:
git commit -m 'Add amazing feature'
- Push to branch:
git push origin feature/amazing-feature
- Open a Pull Request
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
🎉 Acknowledgments
- OpenAI for GPT-4 API
- QuillBot for design inspiration
- FastAPI for the excellent Python framework
- React for the beautiful user interface
- Vercel for seamless deployment
Made with ❤️ for email marketers who want to optimize their campaigns with AI
📧 Questions? Open an issue or reach out! @ aceatdeveloping@gmail.com
- 🔄 Fallback Mode: Works with or without OpenAI API key
🧪 Test the App Locally
- Backend: http://localhost:8000/docs (API documentation)
🛠️ Technical Details
Frontend Stack:
- React 18 with TypeScript
- CSS3 Animations for email emoji loading
- Responsive Design with mobile-first approach
- Modern Build Tools (Vite/Create React App)
Backend Stack:
- Flask Python web framework
- RESTful API design
- CORS enabled for cross-origin requests
- JSON responses with consistent error handling
Deployment:
- Vercel for both frontend and serverless functions
- Automatic CI/CD from Git commits
- Global CDN for fast worldwide access
- Environment variables for secure configuration
🚀 Performance Features
- ⚡ Fast Loading: Optimized React build with code splitting
- 🎨 Smooth Animations: 60fps email emoji orbital animations
- 📱 Mobile Optimized: Touch-friendly interface and responsive design
- 🔄 Real-time Updates: Instant API responses and state management
- 💾 Campaign History: Save and revisit analysis results
🤝 Contributing
This project showcases modern full-stack development practices:
- Clone the repository
- Follow the setup instructions above
- Create feature branches for changes
- Test locally with
vercel dev
- Deploy your improvements
📧 Contact & Support
Built with ❤️ using React, Flask, and AI • Deployed on Vercel • © 2024 MailMind AI