Skip to content
Composer & Rich Text Editor

Composer & Rich Text Editor

Message Composition & Rich Text Editor

The DodaMail Composer (Composer.tsx) is a distraction-free, professional email authoring suite. It combines a rich text formatting engine (RichTextEditor.tsx), smart auto-complete for contacts, intelligent forgotten-attachment detection, scheduled delivery, and a 5-second safety undo window.


The Composer Window Architecture

You can launch the composer by clicking the + Compose button on the sidebar or pressing Ctrl+N (Cmd+N). It can run as a floating docked window in the bottom-right or maximized to full-screen.

Control-by-Control Breakdown of Composer Elements

#Control NameControl TypeDefault StateBehavior & Purpose
1From Account SelectorDropdown SelectorDefault AccountSelects which configured identity and SMTP server will transmit the email. Changing the account automatically updates the default signature attached to the message.
2“To” Recipient FieldAutocomplete Pill InputEmptyAccepts destination email addresses. As you type, searches your local contacts database and frequent recipients with auto-complete. Displays VIP badges next to starred contacts.
3“Cc” Toggle ButtonText ButtonHiddenReveals the Carbon Copy (Cc) recipient input line.
4“Bcc” Toggle ButtonText ButtonHiddenReveals the Blind Carbon Copy (Bcc) recipient line.
5Subject LineText InputEmptyThe subject line of your message. Supports emojis and international characters.
6AI Subject Generator (Magic Wand)Action Icon ButtonEnabledAnalyzes the text currently written in the email body and generates three high-conversion, professional subject line suggestions.
7Formatting Toolbar Toggle (A)Icon ButtonActive (Visible)Toggles visibility of the Rich Text formatting toolbar.
8Attach File Button (Paperclip)File Picker TriggerEnabledOpens the OS native file dialog to attach documents, images, archives, or PDFs. Also supports dragging and dropping files directly into the window.
9Insert Template / Snippet DrawerIcon ButtonEnabledOpens a slide-out drawer containing your pre-written canned response templates and dynamic variable snippets.
10Signature SelectorDropdown MenuAccount DefaultAllows switching between different pre-configured signatures (e.g., Corporate HTML, Brief Mobile, or None).
11Schedule Send Button (Clock)Icon ButtonEnabledOpens the Schedule Send Dialog to defer delivery to a specific future date and time.
12AI Proofreader ButtonIcon ButtonEnabledLaunches the inline spelling, grammar, tone, and cliché analyzer.
13Discard Draft Button (Trash)Danger Icon ButtonEnabledDeletes the work-in-progress draft. If text has been typed, prompts the Discard Confirmation Modal to prevent accidental data loss.
14“Send Email” ButtonPrimary Action ButtonEnabledTransmits the email immediately via SMTP (Ctrl+Enter). Initiates the 5-second Undo Send timer.

The Rich Text Formatting Toolbar (RichTextEditor.tsx)

DodaMail provides a full-featured WYSIWYG editor supporting standard semantic HTML output. Every tool button on the editor toolbar is detailed below:

Icon / ToolTool NameShortcutOutput / Effect
BBoldCtrl+BWraps selected text in <strong> tags for heavy emphasis.
IItalicCtrl+IWraps selected text in <em> tags for italicized emphasis.
UUnderlineCtrl+UUnderlines selected text using <u>.
SStrikethroughCtrl+Shift+XApplies strike-through line via <del> tags.
H1Heading 1Ctrl+Alt+1Formats selection as a major title block (<h1>).
H2Heading 2Ctrl+Alt+2Formats selection as a section subheading (<h2>).
ParagraphCtrl+Alt+0Converts selection back to normal body text (<p>).
•=Bulleted ListCtrl+Shift+8Inserts an unordered bullet list (<ul><li>...</li></ul>).
1.=Numbered ListCtrl+Shift+7Inserts an ordered numeric list (<ol><li>...</li></ol>).
“”Quote BlockCtrl+Shift+9Indents and styles selected text as a blockquote (<blockquote>).
</>Code BlockCtrl+Alt+CCreates a monospaced syntax block for snippets (<pre><code>).
cInline CodeCtrl+ `Applies inline monospaced styling to terms or commands.
🔗Insert LinkCtrl+KOpens link dialog asking for Display Text and Destination URL (href).
🎨Text ColorPaletteOpens color swatch picker to change text foreground color.
🖍Highlight ColorPaletteChanges background highlight color for marked text.
⇤Align LeftCtrl+Shift+LAligns paragraph text to the left margin.
≡Align CenterCtrl+Shift+ECenters paragraph text.
⇥Align RightCtrl+Shift+RAligns paragraph text to the right margin.
▦Insert TableGrid PickerLets you select rows and columns (e.g., 3x3) to insert a styled responsive table.
🧹Clear FormattingCtrl+\Strips all styling, fonts, colors, and links, resetting to plain text.
↩UndoCtrl+ZReverts the last typing or formatting change.
↪RedoCtrl+YRe-applies the previously undone modification.

Dialogs Associated with the Composer

1. The Forgotten Attachment Guard (ForgottenAttachmentModal.tsx)

If your message body contains phrases indicating attachments (e.g., “please find attached”, “I have attached”, “see attached file”, “enclosed invoice”), but you attempt to click Send without adding any files, DodaMail intercepts the action and displays this safety prompt:

Controls on the Forgotten Attachment Dialog

  • Detected Keyword Alert: Highlights the specific sentence that triggered the alert (e.g., "I have attached the spreadsheet").
  • “Attach Files” Button: Cancels transmission and immediately launches the OS file browser so you can select the intended document.
  • “Send Anyway” Button: Overrides the warning and delivers the email without attachments.
  • “Cancel” Button: Closes the modal and returns focus to the editor.

2. Discard Draft Confirmation Dialog

To prevent catastrophic accidental data loss when closing or clicking Discard on a composed email with content:

  • “Keep Editing” Button: Dismisses the dialog and keeps your draft intact in the editor.
  • “Discard Draft” Button: Deletes the temporary draft from the local SQLite storage and closes the composer window.

3. Attachment Lightbox Modal (AttachmentLightboxModal.tsx)

Clicking any attached image, PDF, or media file in either the Composer or Thread View opens the Attachment Lightbox:

Controls in the Lightbox

Control NameIcon / KeyAction
Zoom In / Zoom Out+ / -Scales the visual preview smoothly from 25% to 400%.
Rotate↻Rotates the image orientation 90 degrees clockwise.
Download FileDownload IconPrompts OS “Save File As” dialog to save the file locally.
Copy to ClipboardCopy IconCopies the rendered image data directly to your clipboard.
FullscreenExpand IconToggles distraction-free full-screen inspection mode.
CloseEsc / XCloses the lightbox view.

The 5-Second Undo Send Window

When you click Send or press Ctrl+Enter, DodaMail holds the message in an active volatile memory queue for 5 seconds before opening the SMTP socket:

Note

Live Undo Send Banner:
When dispatching, a floating notification appears: “Sending message… [ Undo (5s) ] [ ✕ ]”. Clicking Undo immediately cancels transmission and re-opens your email draft in the editor.

  • “Undo” Button: Immediately halts the transmission pipeline, returns the email to the composer editor, and removes the pending job from the dispatch queue.
  • Auto-Dismiss: Once the countdown reaches 0, DodaMail opens the encrypted TLS connection to your SMTP server, sends the MIME payload, and saves a local copy in your Sent folder.
Stay Updated

Subscribe to Our Newsletter

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

No spam. Unsubscribe anytime.