Getting Started

Overview

MonoMail is an open-source, monochrome email client for Android. No colour accents, no noise, just email. Connects to Gmail, Microsoft Outlook, and any IMAP/SMTP provider.

Key features

• Gmail (OAuth), Outlook (OAuth), and IMAP/SMTP support
• Multi-account (up to 10 accounts simultaneously)
• Unified Inbox — all accounts, one tab
• Conversation View with collapsible threads
• Snooze threads, swipe gestures, bulk multi-select
• Schedule send with undo, email templates, send-as aliases
• HTML compose with formatting toolbar
• PGP encryption and signing
• In-app attachment viewer (photos, PDFs, videos)
• Offline-first: all data stored locally with SQLCipher encryption
• Adaptive background sync with push notifications

Technical specs

Property	Value
Min Android version	8.0 (API 26)
Target Android version	15 (API 35)
Language	100% Kotlin
Database	Room + SQLCipher (encrypted)
Architecture	Multi-module: 6 core + 6 feature modules
License	GPL-3.0

---

Installing the APK

Download the latest .apk from the GitHub Releases page. Install directly on your device. You may need to enable "Install unknown apps" for your file manager or browser.

There are two build flavors:

Flavor	Description
GitHub	Published on GitHub Releases. Google Sign-In is temporarily disabled while OAuth verification is in progress. Outlook and IMAP work without restriction.
Play Store	Published to Google Play. All sign-in methods work.

First launch

1. Open MonoMail.
2. Swipe through the welcome screen and tap Get Started.
3. Choose your sign-in method:
   • Google — uses your device's Google Accounts (Credential Manager).
   • Microsoft — opens browser-based auth via Microsoft Authentication Library.
   • Other (IMAP/SMTP) — manual server configuration.
4. Grant notification permission when prompted (Android 13+).
5. You're in. The inbox loads from the server and syncs in the background.

Adding more accounts

• Tap your avatar in the top-left corner → Add Account.
• Or go to Settings → Accounts → Add Account.

---

Building from source

Prerequisites

• Android Studio Ladybug or later
• JDK 17+
• Android SDK (API 26 through 37)
• A Google Cloud project with the Gmail API enabled (for Google Sign-In)
• A Microsoft Azure App Registration with Outlook/Microsoft Graph API scopes: Mail.Read, Mail.ReadWrite, Mail.Send, User.Read

Setup

git clone https://github.com/shrivatsav-0/monomail.git
cd monomail

Create secrets.properties in the project root:

GOOGLE_CLIENT_ID=your_web_client_id_here
PUSH_BACKEND_URL=https://your-push-worker.workers.dev

Build commands

# Debug (no API keys needed)
./gradlew assembleGithubDebug

# Debug (with API keys from secrets.properties)
./gradlew assemblePlaystoreDebug

# Release AAB for Play Store
./gradlew bundlePlaystoreRelease

# Release APK for GitHub
./gradlew assembleGithubRelease

# Install on device
./gradlew installGithubDebug