MailShieldAI

v1.0.0 — Initial Release

Release Date: December 23, 2025

What’s New

This is the first official release of MailShieldAI, an AI-powered personal email security dashboard designed to detect and analyze phishing and other email-based threats in real time.

Key Features

• Gmail integration for syncing and analyzing incoming emails
• Real-time threat scoring and risk categorization
• Secure authentication using Google OAuth
• Dashboard UI built with Next.js and React
• Background worker for continuous email processing
• PostgreSQL database support (recommended with Google Cloud SQL)

Architecture

MailShieldAI consists of three primary components:

• Dashboard (Next.js + React)
  User-facing interface for email insights and threat visibility

• Backend API (FastAPI)
  Handles authentication, email ingestion, synchronization, and statistics

• Agent Worker (Python)
  Background processing for email analysis and classification

Getting Started

To run the project locally:

1. Clone the repository
2. Configure environment variables using example.env
3. Start the backend and frontend services
4. Sign in with a Google account to begin syncing emails

Refer to SETUP.md for full setup instructions.

Supported API Endpoints

• GET /health — Service health check
• GET /api/me — Authenticated user details
• GET /api/emails — List analyzed emails
• POST /api/emails/sync — Sync emails from Gmail
• GET /api/stats — Email and threat statistics

Security

MailShieldAI includes the following security measures:

• Google OAuth–based authentication
• Strict CORS and environment validation
• Structured threat classification and risk scoring

Roadmap

• Add automated testing coverage
• Improve background worker performance
• Cloud-native deployment (Google Cloud Platform)