DodaMail
DodaMail
DodaMail Documentation
Welcome to the official documentation for DodaMail, the professional, privacy-first desktop email client engineered for power users, developers, and security-conscious individuals. Built on top of a native Rust core, local SQLite with Full-Text Search (FTS5), and a responsive React frontend, DodaMail delivers desktop email management with instant search, zero telemetry, and complete local data sovereignty.

What Is DodaMail?
Traditional webmail and cloud-connected desktop clients route your keystrokes, contact lists, and message indexes through third-party servers. DodaMail takes a fundamentally different architectural stance:
- Local-First Storage: All messages, drafts, folders, labels, and contacts reside in an encrypted or sandboxed local SQLite database on your machine.
- Lightning-Fast SQLite FTS5 Indexing: Search through tens of thousands of emails in under 10 milliseconds using SQLite’s native BM25 full-text ranking engine.
- Hardware-Free 2-Seat Device Licensing: Enjoy a generous 30-day full trial with reminders, followed by a perpetual/subscription license permitting 2 concurrent seats (e.g., your office PC and personal laptop) with seamless atomic transfer and zero hardware lockout upon RAM or SSD upgrades.
- Desktop Bottom Status Bar: Complete system vitals at a glance: live online state, relative sync timer, connection diagnostics, folder metrics, layout view toggles, and 34 language options.
- 1-Click Move to Label (
V): Gmail-compatible custom labels allowing you to clear your Inbox and file messages with a single keystroke. - Live Connection Diagnostics: Built-in 6-test troubleshooter testing DNS, latency, IMAP, SMTP, outbox storage, and license validity with 1-click solutions.
- Simplified 2-Option Backups: Clean
.zip(Complete Backup withREADME.txt) and.jsonexport options, backed by OS Credential Vault security. - OS Credential Vault Protection: Account credentials and tokens are secured within your operating system’s native keychain (GNOME Keyring / Secret Service on Linux, Windows Credential Manager on Windows, and Apple Keychain on macOS).
- Zero Telemetry & Spy Pixel Neutralization: External tracking pixels, hidden web beacons, and invasive telemetry are detected and neutralized before they can leak your IP address or reading habits.
- Built-in Offline Resilience & Outbox Queue: Read, organize, draft, and queue messages completely offline; DodaMail transparently delivers queued messages the instant internet connectivity is restored.
Architectural Overview
graph TD
UI["Desktop User Interface<br/>(React 18 + TypeScript + Tailwind CSS)"]
IPC["Tauri IPC Bridge / Fast Local Proxy"]
CORE["Rust Native Engine<br/>(IMAP/TLS, SMTP/TLS, Network Sentinel, MIME Parser)"]
VAULT["OS Encrypted Credential Vault<br/>(Secret Service / Keyring / DPAPI)"]
DB["Local SQLite & FTS5 Database<br/>(BM25 Search, Outbox Queue, Cache)"]
UI <--> IPC
IPC <--> CORE
CORE <--> VAULT
CORE <--> DB
Documentation Roadmap
| Section | Description |
|---|---|
| Getting Started | Installation, system requirements, first-run wizard, and account setup. |
| Interface & Navigation | The 3-pane layout, Desktop Bottom Status Bar, Gmail custom labels, and 1-click Move to Label. |
| Multi-Account Management | Adding Gmail, Outlook, Yahoo, and custom IMAP/SMTP accounts. |
| Composer & Editor | Rich text editing, forgotten attachment detection, and 5-second undo send. |
| Offline Mode & Outbox | Offline resilience, local message queueing, and auto-retry delivery. |
| Backup & Security | Simplified .zip and .json backups, OS Credential Vault protection. |
| 2-Seat Device Licensing | 2-seat device licensing, zero RAM lockout, atomic seat transfers. |
| Troubleshooting & Errors | Live 6-test connection diagnostics, license verification, and error resolutions. |
| Command Palette & Shortcuts | Ctrl+K palette, navigation shortcuts, and custom keybindings. |