UniSync

UniSync is a premium unified inbox for university students that merges Gmail and Outlook with AI-powered summaries, priority scoring, and security analysis. It is designed for speed, clarity, and real-time updates with zero polling.

Features

• Unified inbox across Gmail and Outlook
• Push-based ingestion (Gmail Pub/Sub, Microsoft Graph webhooks)
• AI summaries, priority scoring, phishing detection, smart categories
• Full-text search with Postgres tsvector
• Labels, snooze, archive, undo send, and rich compose
• Realtime updates via WebSocket gateway
• Calendar sync with suggested events

Architecture

flowchart LR
  FE[Frontend] --> API[FastAPI API]
  API --> DB[(Postgres)]
  API --> REDIS[(Redis Queue)]
  WEBHOOKS[Webhooks] --> API
  REDIS --> WORKER[Worker]
  WORKER --> DB
  WORKER --> GEMINI[Gemini API]
  API --> WS[Realtime WebSocket]
  WS --> FE

Loading

ERD

erDiagram
  users ||--o{ linked_accounts : has
  users ||--o{ emails : owns
  users ||--o{ labels : owns
  emails ||--o{ email_labels : tagged
  labels ||--o{ email_labels : tagged
  emails ||--o{ suggested_events : produces
  users ||--o{ suggested_events : owns
  users ||--o{ contacts : owns
  users ||--o{ security_logs : owns
  users ||--o{ drafts : owns

Loading

Quick Start

1. Copy .env.example to .env and fill in required values.
2. Run docker-compose up.
3. Apply migrations using your Postgres client (files in backend/migrations).
4. Visit the frontend at http://<your-host>:5173.

Environment Setup

• Backend reads .env from the repo root.
• Frontend reads VITE_* variables.

Deployment (Railway)

• Use railway.json and set env vars in Railway.
• Deploy services: api, worker, and frontend.

API Reference

• Swagger UI available at /docs when the API is running.

Contributing

• Run npm run build in frontend and ensure python -m compileall app passes in backend.
• Keep UI consistent with the design system in frontend/src/styles.