Magimail
A native macOS desktop client for Gmail. Gmail itself runs in an isolated Chromium partition per
account; the surfaces around it are native: an AppKit NSToolbar, a SwiftUI settings window and menu
bar popover, UNUserNotificationCenter banners, a Share Sheet in both directions, and WidgetKit
widgets.
Magimail signs in with the existing web session cookies, so it holds no Google Cloud project, no OAuth scope and no CASA audit. Unread counts and notifications come from Gmail's authenticated Atom feed rather than an API.
What's in this folder
| Document | Covers |
|---|---|
overview.md |
The tree, window architecture, sessions and styling |
process-model-and-ipc.md |
Magimail's channels on top of the shared process model |
atom-feed.md |
The Atom feed, its payload, and the poller |
notifications.md |
Notification dispatch, categories, and the dock badge |
actions.md |
Acting on a message or thread, the two dispatch paths, and read state |
widgets.md |
WidgetKit families, the snapshot cache, and the timeline reloader |
dark-mode.md |
The page-invert filter and every selector it exempts |
menu-bar.md |
Menu bar glyph, SwiftUI popover, and unread feed aging |
share-and-handlers.md |
Inbound Share Sheet, synthesised drag, PDF export, and mailto: handling |
focus-filters.md |
App Intents Focus Filters, account suppression, and dimming |
quick-compose.md |
Global ⌥⌘C shortcut, detached compose window, and account picker |