How manikpruthi/mac-mail works
Mac Mail is a native macOS client whose central workflow is to open cached mail, synchronize account changes, and present messages for reading or action. The app delegate launches the three-pane interface; UI requests go through the app-wide mail service to per-account sync engines, network protocols, and the local store. Separate branches cover composing and queued sending, search, protected rendering, attachments, saved .eml messages, and settings. The README documents these capabilities; links among unsampled components are omitted unless supported by the source index or README.
Main entry points: MailService.swift Mail service · AccountEngine.swift Account sync engine · MainWindowController.swift Mail window · PreviewViewController.swift Reading pane
Components 34
App and interface
- App lifecycle
Sources/App/AppDelegate.swift - Mail window
Sources/UI/MainWindowController.swift - Folder sidebar
Sources/UI/SidebarViewController.swift - Message list
Sources/UI/MessageListViewController.swift - Search filters
Sources/UI/SearchFilterBar.swift - Account settings
Sources/UI/SettingsWindowController.swift - Reading pane
Sources/UI/PreviewViewController.swift - Message window
Sources/UI/MessageWindowController.swift
Mail content
- Composer
Sources/UI/ComposeWindowController.swift - Format bar
Sources/UI/FormatBar.swift - Message actions
Sources/UI/MessageActions.swift - HTML protection
Sources/UI/HTMLPrep.swift - Image loading
Sources/UI/ImageLoader.swift - Attachment handling
Sources/UI/AttachmentBar.swift - Saved message window
Sources/UI/EMLWindowController.swift - EML document
Sources/Mail/EMLDocument.swift - MIME parsing
Sources/Mail/MIME.swift - Mail safety
Sources/Mail/MailSafety.swift - Message builder
Sources/Mail/MessageBuilder.swift - Search query
Sources/Mail/SearchQuery.swift
Sync and network
- Mail service
Sources/Sync/MailService.swift - Account sync engine
Sources/Sync/AccountEngine.swift - Offline outbox
Sources/Sync/Outbox.swift - IMAP client
Sources/Net/IMAPClient.swift - IMAP parser
Sources/Net/IMAPParser.swift - SMTP client
Sources/Net/SMTPClient.swift - TLS stream
Sources/Net/TLSStream.swift
Local state
- Offline mail store
Sources/Core/Store.swift - SQLite layer
Sources/Core/SQLite.swift - Preferences
Sources/Core/Prefs.swift - Credential storage
Sources/Core/Keychain.swift - Diagnostics log
Sources/Core/Debug.swift
External services
- IMAP account server
Other components
- Mail user
Connections 48
- Mail user → App lifecycle: launches
Sources/App/AppDelegate.swift - App lifecycle → Mail window: opens
Sources/App/AppDelegate.swift - Mail window → Folder sidebar: hosts
Sources/UI/MainWindowController.swift - Mail window → Message list: hosts
Sources/UI/MainWindowController.swift - Mail window → Reading pane: hosts
Sources/UI/MainWindowController.swift - Mail window → Message window: opens
Sources/UI/MainWindowController.swift - Mail window → Search filters: uses
Sources/UI/MainWindowController.swift - App lifecycle → Account settings: opens
Sources/App/AppDelegate.swift - Message list → Search query: parses search
Sources/UI/MessageListViewController.swift - Search filters → Search query: builds filters
Sources/UI/SearchFilterBar.swift - Message list → Mail service: requests mail
Sources/UI/MessageListViewController.swift - Folder sidebar → Mail service: requests folders
Sources/UI/SidebarViewController.swift - Account settings → Mail service: updates accounts
Sources/UI/SettingsWindowController.swift - Reading pane → Mail service: fetches messages
Sources/UI/PreviewViewController.swift - Reading pane → HTML protection: prepares HTML
Sources/UI/PreviewViewController.swift - Reading pane → Image loading: loads images
Sources/UI/PreviewViewController.swift - Reading pane → Attachment handling: shows attachments
Sources/UI/PreviewViewController.swift - Message window → Reading pane: embeds reader
Sources/UI/MessageWindowController.swift - Message window → Message actions: offers actions
Sources/UI/MessageWindowController.swift - Message window → Composer: opens reply
Sources/UI/MessageWindowController.swift - Mail window → Message actions: dispatches actions
Sources/UI/MainWindowController.swift - Composer → Format bar: uses formatting
Sources/UI/ComposeWindowController.swift - Composer → Mail service: sends messages
Sources/UI/ComposeWindowController.swift - Composer → Message builder: builds message
Sources/UI/ComposeWindowController.swift - Composer → Offline outbox: queues drafts
Sources/UI/ComposeWindowController.swift - Saved message window → EML document: opens document
Sources/UI/EMLWindowController.swift - Saved message window → Reading pane: uses reader
Sources/UI/EMLWindowController.swift - Saved message window → Attachment handling: shows attachments
Sources/UI/EMLWindowController.swift - Mail service → Account sync engine: manages engines
Sources/Sync/MailService.swift - Mail service → Offline outbox: flushes queue
Sources/Sync/MailService.swift - Account sync engine → Offline mail store: updates cache
Sources/Sync/AccountEngine.swift - Account sync engine → IMAP client: synchronizes
Sources/Sync/AccountEngine.swift - Account sync engine → SMTP client: sends mail
Sources/Sync/AccountEngine.swift - Account sync engine → Credential storage: reads credentials
Sources/Sync/AccountEngine.swift - Account sync engine → Search query: uses search
Sources/Sync/AccountEngine.swift - Account sync engine → Message builder: builds outgoing mail
Sources/Sync/AccountEngine.swift - Account sync engine → Diagnostics log: records errors
Sources/Sync/AccountEngine.swift - IMAP client → IMAP parser: parses responses
Sources/Net/IMAPClient.swift - IMAP client → TLS stream: uses transport
Sources/Net/IMAPClient.swift - SMTP client → TLS stream: uses transport
Sources/Net/SMTPClient.swift - SMTP client → Mail safety: checks content
Sources/Net/SMTPClient.swift - Message builder → Mail safety: sanitizes headers
Sources/Mail/MessageBuilder.swift - Mail service → Offline mail store: owns cache
Sources/Sync/MailService.swift - Offline mail store → SQLite layer: persists data
Sources/Core/Store.swift - Offline mail store → Search query: runs local search
Sources/Core/Store.swift - Mail service → Preferences: loads settings
Sources/Sync/MailService.swift - IMAP client → IMAP account server: connects to
- SMTP client → IMAP account server: sends via account