Skip to content

VARA4u-tech/MAIL-MIND-AI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

125 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

MailMind AI Logo

MAILMIND AI

The Next Evolution of Intelligent Email Management

Status Security

React TypeScript Node.js MongoDB OpenRouter

MailMind AI is a professional-grade, AI-powered email assistant designed to streamline your communication workflow. By leveraging advanced Large Language Models (Gemma 2 27B), it transforms your inbox from a static list of messages into a dynamic command center.


Description

MailMind AI is built to solve the modern crisis of "Inbox Overload." Instead of spending hours reading through long threads and manually drafting repetitive replies, MailMind AI acts as your intelligent executive assistant.

Developed through multiple Agile Sprints, the platform was designed with a focus on speed, precision, and privacy. The project uses a Brutalist-Modern design language that strips away unnecessary clutter, providing a high-performance experience even on low-end mobile devices. By connecting directly to the Gmail and Google Calendar APIs, it creates a seamless bridge between your conversations and your schedule.


Key Features

Feature Description
🧠 Smart Summarization Instantly distill long threads into 3 actionable bullet points.
βœ‰οΈ Intent-Based Replies Generate professional, polite, or direct replies with a single click.
πŸ“… Auto-Scheduling Automatically detects meeting requests and generates one-click Google Calendar links.
πŸ”” Live Notifications Real-time polling for new messages and AI background processing alerts.
πŸ“± Cross-Platform Fully responsive design optimized for Mobile, Tablet, and Desktop views.

Agile Header

This project was developed using Agile best practices, ensuring continuous improvement through iterative cycles and feedback loops.

πŸƒβ€β™‚οΈ Sprints & Iterations

Sprint 1: The Foundation

  • Goal: Establish core infrastructure and OAuth security.
  • Outcome: Implemented Google OAuth 2.0 flow, MongoDB user storage, and the Brutalist-Modern UI framework.

Sprint 2: Intelligence Integration

  • Goal: Connect the AI engine and Gmail services.
  • Outcome: Integrated OpenRouter API (Gemma 2), built the Gmail inbox crawler, and implemented the AI Action Panel.

Sprint 3: UX Refinement & Polish

  • Goal: Finalize responsiveness and performance.
  • Outcome: Optimized for low-end mobile devices (Samsung M11), implemented Tablet Drawer logic, and added the Live Notification Hub.

Technical Stack

Frontend

  • React 18 + Vite (Next-gen bundling)
  • TypeScript (Type-safe development)
  • Framer Motion (High-end scroll-linked animations)
  • Tailwind CSS (Utility-first styling)
  • Lucide Icons (Vector-perfect iconography)

Backend

  • Node.js + Express
  • MongoDB (User session & AI history storage)
  • Google APIs (Gmail & Calendar integration)
  • JWT (Secure stateless authentication)
  • Helmet & Rate Limiter (Security firewall)

Getting Started

Prerequisites

  • Node.js (v18+)
  • MongoDB Atlas account
  • Google Cloud Console Project (with Gmail & Calendar APIs enabled)

Installation

  1. Clone the Repository

    git clone https://github.com/VARA4u-tech/MAIL-MIND-AI.git
    cd mail-mind-ai
  2. Backend Setup

    cd backend
    npm install
    # Configure your .env file with MongoDB and Google Credentials
    npm run dev
  3. Frontend Setup

    cd ../frontend
    npm install
    npm run dev

Structure Header

mail-mind-ai/
β”œβ”€β”€ backend/
β”‚   β”œβ”€β”€ config/         # Database & Auth configurations
β”‚   β”œβ”€β”€ controllers/    # Business logic (AI, Gmail, Auth)
β”‚   β”œβ”€β”€ models/         # MongoDB Schemas
β”‚   └── routes/         # API Endpoints
└── frontend/
    β”œβ”€β”€ src/
    β”‚   β”œβ”€β”€ components/ # Reusable UI Modules
    β”‚   β”œβ”€β”€ pages/      # Dashboard & Landing layouts
    β”‚   └── assets/     # Branding & Media

Security & Performance

  • Firewall Enabled: Rate limiting and Helmet.js headers protect against brute-force and XSS.
  • Mobile Optimized: Disables heavy animations and backdrop-blurs on low-power mobile devices to ensure smooth scrolling.
  • Stateless Auth: Uses secure JWT tokens passed via Authorization headers.

Contribution

COOKED & SERVED BY VARA

About

"πŸ’ŒMailMind AI is a professional-grade, AI-powered email assistant designed to streamline your communication workflow. By leveraging advanced Large Language Models (Gemma 2 27B), it transforms your inbox from a static list of messages into a dynamic command center."

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors