Skip to content
Interface & Navigation

Interface & Navigation

Interface, Navigation & Thread Management

DodaMail is organized into a clean, intuitive 3-pane desktop workspace designed for high-volume email workflows. Every control, button, badge, and search filter is built for instant responsiveness, keyboard-driven efficiency, and complete local data sovereignty.

DodaMail 3-Pane Desktop Interface


1. The Desktop Bottom Status Bar (StatusBar.tsx)

Located permanently along the bottom of the window, the Bottom Status Bar provides system vitals, live sync counters, quick layout toggles, and direct diagnostics access without cluttering the main workspace.

ComponentControl TypePurpose & Behavior
Online / Offline IndicatorToggle ButtonDisplays a green dot (Online) when connected, or amber (Offline) when disconnected. Clicking toggles Work Offline mode.
Relative Sync TimerAction Button & SpinnerShows live relative time elapsed since the last mailbox synchronization (e.g., Synced just now, Synced 4m ago). When synchronizing, displays a spinning loader and Syncing.... Clicking triggers an immediate sync.
🩺 Diagnostics ButtonAction ButtonLaunches the Troubleshoot & Connection Diagnostics Modal to test sockets, DNS, and licensing with one click.
Active Folder & Unread MetricsInformational TextDisplays current folder title, total conversations, and unread count in real-time (e.g., INBOX: 29 emails (14 unread)).
Outbox Queue CounterStatus Pill (Amber)Appears automatically when messages are awaiting outgoing delivery (e.g., 2 in Outbox). Clicking navigates directly to the Outbox folder.
Selected Threads CounterBadge (Blue)Indicates how many email threads are currently selected for batch triage (e.g., 3 selected).
Split View / Full Window ToggleLayout ButtonSwitches between Split View (Thread list and Reading Pane side-by-side) and Full Window reading mode. Shortcut: Ctrl+M or \.
Contacts Quick AccessAction ButtonOpens the Contacts & Address Book Manager (Shift+C).
Shortcuts ReferenceAction ButtonDisplays the complete keyboard shortcuts overlay (?).
Theme Toggle (🌙 / ☀️)Theme SwitcherInstantly toggles between battery-saving Dark Mode and crisp Light Mode.
Language Switcher (🌐)Locale SelectorDisplays the active interface language code (e.g., EN, HI, MR, ES) and opens language settings covering 34 international and Indian regional languages.
Build Version BadgeSystem InformationDisplays currently installed client release (e.g., v0.1.12).

Tip

The bottom status bar can be toggled on or off at any time under Settings -> General & Display -> Bottom Status Bar.


2. The Sidebar Navigation Pane (Sidebar.tsx)

The sidebar provides access to your account selector, message composition, system folders, custom labels, offline outbox status, trial monitoring, and configuration settings.

Sidebar Interface

Controls on the Sidebar

Control NameControl TypeDescription & Functionality
Sidebar Collapse / ExpandToggle ButtonCollapses the sidebar into a slim, compact icon-only mode (Gmail-style) or expands it back, maximizing screen real estate for email triage and reading.
Account SwitcherDropdown SelectorDisplays currently active mailbox (All Inboxes or specific account). Clicking opens a popover to switch mailboxes or add accounts.
“Compose” Button (+)Primary Command ButtonLaunches a new floating or docked Message Composer window. Also invoked via shortcut Ctrl+N (Cmd+N).
Commands ButtonAction ButtonLaunches the Universal Command Palette (Ctrl+K).
Contacts ButtonAction ButtonOpens the Contacts Directory (Shift+C).
“All Inboxes”Navigation FolderDisplays a unified chronological view of incoming emails across all configured accounts.
“Inbox”Navigation FolderStandard incoming message directory. Displays a numeric badge indicating unread messages.
“Starred”Navigation FolderDisplays all messages flagged with a star for follow-up or VIP tracking.
“Pinned”Navigation FolderDisplays messages pinned to the top of your triage list.
“Snoozed”Navigation FolderConversations deferred until a later date or time.
“Muted”Navigation FolderMuted discussions that bypass inbox notifications.
“Notes & Reminders”Navigation FolderConversations with private local notes or due dates attached.
“Sent”Navigation FolderRepository of all transmitted outgoing emails.
“Outbox” (Offline Queue)Navigation Folder & BadgeDisplays emails queued for delivery while offline or during server retries. Displays a red numeric badge when unsent messages are pending.
“Scheduled”Navigation FolderMessages scheduled for future send.
“Labels” Header (+)Collapsible Header & ActionSection heading for custom user tags. Clicking + opens the Manage Labels & Folders dialog.
Custom Label ItemsNavigation Item & Color DotDisplays user-created tags (e.g., ⚡ Action Required, ⏳ Waiting / Pending, 🔍 Review Needed). Clicking filters the thread list to messages carrying that label.
“30-Day Trial Status”Status PillDisplays days remaining in evaluation. Clicking launches the Software Registration Dialog.
“Settings” ButtonFull-Width ButtonOpens the comprehensive Settings Panel (Ctrl+,). To eliminate screen clutter, this single clean button provides unified access to all preferences.

3. Gmail-Style Custom Labels & 1-Click “Move to Label” (V)

DodaMail supports standard Gmail-compatible custom labels and instant folder filing. When you want to clear emails from your Inbox while keeping them safely organized, use the Move to Label workflow.

Manage Labels & Folders

Creating & Managing Labels

  1. In the sidebar, click the + icon next to the Labels section.
  2. In the Manage Labels & Folders Modal:
    • Enter a Label Name (e.g., Taxes, Clients, Invoices).
    • Assign an optional numeric shortcut (e.g., 1, 2, 3).
    • Pick an emoji or vector icon (e.g., ⚡, ⏳, 🔍, 🔁, 💡).
    • Select a distinct accent color from the 10-color palette.
  3. Click Create Label. The label appears immediately in your sidebar and triage menus.

1-Click Move to Label (V)

When viewing an email or selecting conversations in the thread list:

1-Click Move to Label Popover

  1. Press V on your keyboard (or click the Move to button on the reading pane toolbar).
  2. The Move to… popover opens with your custom labels and standard archive options.
  3. Select your desired label or press its numeric shortcut (1-9).
  4. DodaMail automatically:
    • Attaches the selected label to the conversation.
    • Archives the conversation out of your Inbox.
    • Clears clutter from your incoming stream while preserving the message permanently in the label folder.

4. The Thread List Pane (ThreadList.tsx)

The central pane displays email conversations matching your current folder, label, or search query.

Thread List

Top Toolbar Controls in Thread List

Control NameControl TypeAction & Behavior
Select All CheckboxMaster CheckboxToggles selection of all visible threads in the list. Supports partial indeterminate state.
Decluttered Search BarFull-Width InputExpansive input field with fast FTS5 search. Features a circular refresh icon on the right to trigger instant mail sync.
Category TabsUnderlined Segmented TabsSwitch between All Mail (1), Primary (2), Social (3), Promotions (4), Newsletters (5), Receipts (6), and Alerts (7).
Action Quick FiltersStackable Filter ChipsToggle cumulative filters for Unread, Starred, Attachments, VIP Contacts, Needs Reply, Today (< 24h), and Large (> 5MB).
Clear Filters (✕)Reset ButtonAppears whenever quick filters are active to reset back to the full folder view in a single click.
Batch Action: ArchiveIcon ButtonMoves all selected threads into the Archive folder (E).
Batch Action: DeleteIcon ButtonMoves all selected threads into the Trash (# or Delete).
Batch Action: Mark Read/UnreadIcon ButtonToggles read status for all selected threads (U).
Batch Action: Star/UnstarIcon ButtonToggles star flag for all selected threads (S).
Batch Action: Apply LabelDropdown ButtonOpens a checklist of existing labels to batch-tag selected threads (L).
Batch Action: Move to FolderDropdown ButtonMoves selected conversations to any label or folder (V).
Batch Action: SnoozeIcon ButtonOpens the Snooze picker to postpone selected threads (Z).

4.1 Smart Inbox Category Tabs

DodaMail separates inbox messages into seven intelligent categories positioned as prominent underlined segmented tabs (Gmail/Linear style) across the top of your inbox:

Category TabShortcutClassification Heuristics & Purpose
📬 All Mail1Complete unified incoming stream. Automatically displays inline category badges (💬 Social, 🏷️ Promotions, 🧾 Receipts, 📰 Newsletters, 🔔 Alerts).
👤 Primary2Direct, personal, and business conversations sent directly to you. Excludes bulk automated mailings.
💬 Social3Automated notifications and social digests from LinkedIn, Pinterest, Twitter/X, Facebook, Instagram, Reddit, YouTube, TikTok, Discord, and developer communities.
🏷️ Promotions4Marketing newsletters, special discount offers, coupon codes, and commercial campaigns.
📰 Newsletters5Curated email digests, Substack blogs, industry roundups, and editorial content.
🧾 Receipts & Billing6Invoices, purchase confirmations, payment receipts, order tracking, and account statements.
🔔 Alerts & Security7System alerts, security login notifications, server status updates, and two-factor authentication (2FA) verification codes.

4.2 Stackable Action Quick Filters

Rendered directly beneath the category tabs as interactive filter chips with live matching counts:

  • Unread: Isolate conversations containing unread messages.
  • Starred: Show only priority conversations marked with a star.
  • Attachments: Show emails containing files, documents, or media.
  • VIP Contacts: Show emails originating from senders saved in your local address book VIP list.
  • Needs Reply / Follow-up: Automatically identifies incoming emails awaiting your response or follow-up.
  • Today (< 24h): Filters messages received within the last 24 hours for rapid daily triage.
  • Large Files (> 5MB): Identifies storage-heavy messages containing oversized attachments.
  • Multi-Filter Stacking: Filters can be stacked cumulatively (AND logic). For example, select Needs Reply and Large Files simultaneously to quickly triage heavy items needing action.
  • One-Click Clear: When one or more filters are active, an inline Clear (✕) button appears to reset all filters instantly.

4.3 Right-Click Context Menu (ThreadContextMenu.tsx)

Right-clicking any conversation row anywhere in the thread list opens a desktop-style context menu for instant one-click triage:

  • Open Conversation: Opens the email into the reading pane (Enter / O).
  • Reply (R): Prepares a direct reply to the sender.
  • Reply All (A): Prepares a reply to all conversation participants.
  • Forward (F): Forwards the email thread with attached files.
  • Star / Unstar (S): Toggles the priority star flag.
  • Mark as Read / Unread (U): Toggles the unread state.
  • Move to Label / Folder (V): Opens the 1-click label filing menu with auto-archive.
  • Snooze (B / Z): Temporarily defers the conversation.
  • Archive (E): Moves the conversation to Archive.
  • Delete (# / Delete): Moves the conversation to Trash.

5. The Thread Reading Pane (ThreadView.tsx)

The right-hand pane renders the complete conversation history with full MIME formatting, inline security audits, and response tools.

Reading Pane

Reading Pane Action Toolbar

The top bar of the reading pane provides actions for the active conversation:

ControlAction DescriptionKeyboard Shortcut
“Reply”Opens the composer pre-filled with the original sender’s address and quoted text.R
“Reply All”Opens the composer including all original To and Cc recipients.A
“Forward”Opens the composer ready to enter new destination recipients with all attachments attached.F
“Notes”Opens the private thread notes sidebar to attach personal reminders or due dates.N / Alt+N
“Contact”Opens the Contact Intelligence panel showing relationship vitals, conversation history, and shared files.Alt+I
“Move to”Opens the 1-click label popover to tag and archive from Inbox.V
“Labels”Manages assigned label tags without archiving.L
“Star / Unstar”Toggles follow-up priority star on the active thread.S
“Pin / Unpin”Pins thread to the top of the conversation list.Shift+P
“Print”Launches the dedicated Print Thread Dialog.P
“Snooze”Defers email until a future date or time.Z
“Mute”Suppresses notifications for future replies on this thread.M
“Report Spam”Moves to Spam and trains local filters.!
“Delete”Moves conversation to Trash.#

5.1 Contact Intelligence Panel (ContactIntelligencePanel.tsx)

When viewing an email, clicking the 👤 Contact button on the reading pane toolbar (or pressing Alt+I) opens the docked Contact Intelligence Sidebar. Operating 100% locally and privately on your machine without external cloud dependencies, this panel provides:

  • Contact Profile & Vitals: Full name, contact avatar, clean email address (with 1-click clipboard copy), organization/company domain (acme.com), phone number, and a 1-click VIP Star Toggle (⭐).
  • Relationship Metrics: Total conversation count, relative timestamp of your last interaction (e.g., Just now, Yesterday, 3 days ago), and the date you first connected.
  • Quick Actions: Instant buttons to compose a new email to this contact, search all past correspondence (from:email), or open their entry in the Address Book.
  • Conversation History (Timeline): Chronological stream of all previous threads exchanged with this contact. Clicking any conversation opens it directly in the reading pane.
  • Shared Attachments Hub: A unified gallery of all PDFs, spreadsheets, documents, and media exchanged between you and this contact across all messages, with 1-click file download.
  • CRM Notes & Tasks: Real-time visibility into local private notes and follow-up deadlines attached to threads from this contact.

6. SQLite FTS5 Full-Text Search Engine (ThreadSearchBar.tsx)

Located at the top of the interface, the search bar queries DodaMail’s local SQLite FTS5 (Full-Text Search 5) index. Queries execute locally in under 10 milliseconds without querying remote servers.

Supported Search Syntax & Operators

Search OperatorExample QueryWhat It Finds
from:from:[email protected]Messages sent by a specific email or name.
to:to:[email protected]Messages addressed to a specific recipient.
subject:subject:"Q3 Report"Matches exact words or phrases in the subject line.
has:attachmenthas:attachment invoiceFinds messages containing attachments and mentioning “invoice”.
is:unreadis:unread from:bossFilters to unread messages from a specific contact.
is:starredis:starredFilters to all starred messages.
after:after:2026-01-01Messages received after January 1, 2026.
before:before:2026-10-01Messages received before October 1, 2026.
label:label:UrgentFilters to messages tagged with the “Urgent” label.
folder:folder:SentRestricts search to a specific folder.
ORcontract OR agreementMatches messages containing either word.
NOT / -project -archivedMatches “project” but excludes messages with “archived”.
Stay Updated

Subscribe to Our Newsletter

Product updates, security tips, and release announcements delivered directly to your inbox.

No spam. Unsubscribe anytime.