Command Palette & Shortcuts

Command Palette & Keyboard Shortcuts

DodaMail is designed for high-efficiency keyboard-first navigation. Power users can navigate their entire mailbox, compose replies, apply labels, trigger backups, and change settings without touching the mouse.

1. The Command Palette (`Ctrl+K` / `Cmd+K`)

Press Ctrl+K (Cmd+K on macOS) anywhere in the application to summon the Universal Command Palette (CommandPalette.tsx):

Features & Controls

Fuzzy Search Input: Start typing any command name, action, folder, or contact.
Categorized Results: Actions are organized into intuitive sections:
- Navigation: Jump to any folder, account, or label.
- Mail Actions: Compose, archive, mark read, snooze, trigger sync.
- System & Settings: Open specific Settings tabs, create backup, check license status.
Keyboard Navigation: Use Up (↑) and Down (↓) arrow keys to highlight items; press Enter to execute immediately. Press Esc to close.

2. Global Shortcuts Reference

These shortcuts are active anywhere within DodaMail:

Shortcut (Win / Linux)	Shortcut (macOS)	Action Performed
`Ctrl + N`	`Cmd + N`	Opens a new Message Composer window.
`Ctrl + K`	`Cmd + K`	Opens the Universal Command Palette.
`Ctrl + ,`	`Cmd + ,`	Opens the Settings Panel.
`Ctrl + F` or `/`	`Cmd + F` or `/`	Focuses the SQLite FTS5 Search Bar.
`Ctrl + Shift + S`	`Cmd + Shift + S`	Forces an immediate IMAP/SMTP Mail Sync.
`Ctrl + Shift + B`	`Cmd + Shift + B`	Triggers a Full Local Backup creation.
`?`	`?`	Opens the Keyboard Shortcut Help Modal (`ShortcutHelpModal.tsx`).
`Esc`	`Esc`	Dismisses active modals, lightboxes, or returns focus to thread list.

3. Mailbox & Folder Navigation Shortcuts

Use these two-key sequential combinations (press G followed by the next letter) to instantly navigate between mailboxes:

Shortcut	Destination / Action
`G then I`	Jump to Inbox.
`G then S`	Jump to Starred.
`G then T`	Jump to Sent.
`G then D`	Jump to Drafts.
`G then O`	Jump to Outbox (Offline Queue).
`G then A`	Jump to All Inboxes (Unified View).
`G then C`	Open Contacts Manager.

4. Thread List & Triage Shortcuts

Manage and triage conversations rapidly within the thread list pane:

Shortcut	Action Description
`J` or `Down Arrow`	Move cursor to Next Conversation.
`K` or `Up Arrow`	Move cursor to Previous Conversation.
`O` or `Enter`	Open highlighted conversation into the reading pane.
`X`	Toggle selection checkbox on the highlighted conversation.
`* then A`	Select All visible conversations in the list.
`* then N`	Deselect All conversations.
`E`	Archive selected conversations.
`#` or `Delete`	Delete selected conversations to Trash.
`S`	Toggle Star status on active thread.
`U`	Toggle Read / Unread status.
`V`	Open Move to Folder dropdown picker.
`L`	Open Apply Label tagging checklist.
`Z`	Open Snooze Dialog to defer email.
`!`	Report as Spam / Junk.

5. Thread Reading & Response Shortcuts

When inspecting an active conversation in the reading pane:

Shortcut	Action Description
`R`	Reply to the original sender.
`A`	Reply All to all recipients on `To` and `Cc`.
`F`	Forward conversation with attachments.
`P`	Open Print Thread Dialog.
`M`	Mute Thread (suppresses future alerts for this subject).
`N`	Open Private Thread Notes panel.

6. Message Composer Shortcuts

Format and transmit messages effortlessly while authoring:

Shortcut (Win / Linux)	Shortcut (macOS)	Action Performed
`Ctrl + Enter`	`Cmd + Enter`	Send Message immediately (starts 5s undo timer).
`Ctrl + B`	`Cmd + B`	Apply Bold formatting to selection.
`Ctrl + I`	`Cmd + I`	Apply Italic formatting.
`Ctrl + U`	`Cmd + U`	Apply Underline.
`Ctrl + K`	`Cmd + K`	Open Insert Link dialog.
`Ctrl + Shift + 8`	`Cmd + Shift + 8`	Insert Bulleted List.
`Ctrl + Shift + 7`	`Cmd + Shift + 7`	Insert Numbered List.
`Ctrl + \`	`Cmd + \`	Clear Formatting (resets to plain text).
`Ctrl + Z`	`Cmd + Z`	Undo last change.
`Ctrl + Y`	`Cmd + Shift + Z`	Redo undone change.
`Esc`	`Esc`	Close Composer (prompts discard confirmation).