The Inbox

Layout

The inbox screen is composed of:

1. Search bar (top) — tap to search locally or on the server. Shows a calendar badge when you have scheduled messages pending.
2. Email list — lazy-loaded list of threads with pull-to-refresh.
3. Dock bar (bottom) — configurable navigation tabs in a pill-shaped container. Overflow tabs shown in a popover.

Tabs

Tab	Contents
Unified	All accounts combined (requires Unified Inbox toggle in Settings)
Inbox	Primary inbox for the active account
Sent	Sent messages
Archived	Archived threads
Starred	Starred/flagged threads
Trash	Deleted threads (supports empty-trash action)
Snoozed	Temporarily hidden threads
Spam	Spam folder (supports report-not-spam and empty-spam)

Customising the dock bar

Go to Settings → Navigation. The Dock Bar Editor lets you:

• Reorder tabs (up/down buttons)
• Add tabs from the available list (max 4 primary tabs)
• Remove tabs (minimum 1)

The Nav Size slider scales the dock bar icons and labels from 0.6x to 1.4x.

Thread rows

Each thread in the list shows:

• Avatar — contact photo, falls back to first letter of sender name, then domain favicon
• Sender name — bold if unread
• Subject — bold if unread
• Snippet — shown when "Show Snippet Preview" is enabled in Settings
• Date — relative (Today: time; This week: day name; This year: date; Older: full date)
• Unread indicator — blue dot on the avatar, bold text, background tint
• Star indicator — yellow star icon when starred
• Message count badge — shown for threads with multiple messages

Swipe gestures

Gesture	Action
Tap	Open thread detail
Swipe left	Configurable: Archive, Star, Delete, or Mark Read/Unread
Swipe right	Configurable: Archive, Star, Delete, or Mark Read/Unread
Long-press	Contextual overlay with 4 context-aware action buttons
Long-press avatar	Enter bulk multi-select mode

Swipe backgrounds are colour-coded: Archive → yellow, Star → amber, Delete → red, Mark Read/Unread → blue-grey.

Bulk select mode

Enter by long-pressing any sender avatar. Features:

• Animated checkbox transitions on each item
• Range select — tap an item body to select a range from the last toggled item
• Select all / Deselect all toggle in the top bar
• Floating pill-shaped action bar with: Archive, Delete, Mark Read, Mark Unread, Star
• Shows selected count in the top bar

Undo

After certain actions (archive, delete, snooze, send), an Undo bar appears at the bottom with a 4-second countdown timer. Tap Undo to reverse the action, or let it expire to commit.

Smart grouping

When enabled (Settings → Inbox), threads from the same sender are auto-collapsed into expandable group headers. Threshold: 3+ emails within 24 hours (or 3 days if "Group Recent Only" is off).

Email detail and conversation view

Tap any thread to open the detail screen. Toggle between modes in Settings → Inbox → Conversation View.

Mode	Behaviour
Conversation View (default)	Only the latest message is expanded. Older messages show a snippet and expand on tap.
Message Chain	All messages expanded inline as a continuous scrollable list.

Each message shows the sender, recipients (Cc/Bcc hidden by default), date, HTML body (rendered in a WebView with JavaScript disabled), and attachments. Opening a thread auto-marks all unread emails as read.

Search

The search bar at the top of the inbox filters threads by subject, sender name, or snippet in real-time against the local database. When no local results are found, a "Search server for older emails" prompt triggers a Gmail or Outlook API search.

Scroll and polling

Each tab remembers its scroll position across tab switches. When the app is visible, MonoMail syncs every ~2 minutes. When backgrounded, it uses the configured sync interval (15 min, 30 min, 1 hour, or manual).