Notifications, Sync, and Offline Use

SwiftMail syncs Gmail into local storage and uses the local cache for reading already-synced mail.

Notifications

After sign-in, SwiftMail asks macOS for notification permission. When permission is granted, new mail can appear as a macOS notification with the sender and subject.

Notification actions include:

• Mark as Read
• Archive

Clicking a notification opens the related thread.

SwiftMail does not show a notification banner for new mail while the app is already in the foreground.

Dock badge

The app updates the Dock badge with the current Inbox count. The badge is cleared when there are no Inbox messages counted.

Sync

SwiftMail performs:

• A full sync after sign-in, account switch, or account add.
• Partial refreshes while the app is open.
• Manual refresh from message lists.
• On-demand label and draft sync.

The refresh toolbar button appears on the first page of a message list. Press Command-R to refresh.

Pagination

Large message lists are split into pages. Use the left and right page controls in the toolbar to move between pages. If the next page has not been fetched yet, SwiftMail loads it from Gmail.

Offline banner

When the Mac has no network connection, SwiftMail shows a red No Internet Connection banner at the bottom of the window.

Already-synced messages remain available from the local cache, but actions that require Gmail may fail until the connection returns.