Boogie
A mail client · macOS · iOS · iPadOS · watchOS

Boogie Support

Get help by email

Email support@boogie.digital and we'll reply within 2 business days (AEST). Include your Boogie version, device and OS, and a short description of the issue — screenshots help.

Email support@boogie.digital

Help topics

Getting started

Boogie is a native JMAP email and calendar client. To use it you need a mailbox on a JMAP server — self-hosted Stalwart Mail Server, Fastmail, or any provider that speaks RFC 8620.

Add your first account

  • Open Boogie and enter your email address and password. Boogie discovers your server automatically when it publishes JMAP autodiscovery (.well-known/jmap).
  • If autodiscovery isn't set up, enter the server address yourself (for example mail.example.com).

Fastmail

Fastmail uses an API token, not a password, and doesn't support Boogie's automatic discovery — so you enter the server by hand. In Fastmail, open Settings → Privacy & Security → Manage API tokens and create a token with mail (JMAP) access. Then in Boogie set the server to https://api.fastmail.com/jmap/session and paste the token into the Bearer Token field — not the password field.

Stalwart and other self-hosted servers

Use your full email address and the password from your server. If sign-in fails, confirm the server has JMAP enabled and is reachable from your device — see Troubleshooting.

More than one account

Boogie supports multiple accounts side by side — add more from Settings. Each account keeps its own mailboxes, identities, and sync. Boogie is free to try for 14 days; see Subscription & trial.

Mail

Reading New in 1.3

Remote images are blocked by default. When a message contains them, Boogie shows a banner — tap Load Images to fetch them for that message only. You can change the policy any time in Settings (always load, ask, or never).

Group a thread into one conversation, or read every message on its own — your choice in Settings.

Search

Search runs on your server, so it covers your whole mailbox, not just what's on the device. Delete, move, and flag straight from the results.

Tags

Tag messages and filter by tag. Tags live on the server, so they follow you to every device.

Organising your mail

Archive, delete, move, and flag from the message list or an open message. On iPhone and iPad you can set your own swipe actions in Settings; on the Mac you can also print. See Writing & sending and Settings & accounts.

Spotlight New in 1.3

Your mail shows up in system search — find a message from the Home Screen or the Mac Spotlight bar and jump straight to it.

Writing & sending

Compose from the toolbar or with ⌘N. Reply, reply-all, and forward from any open message.

From address

If you have more than one identity — or more than one account — choose the From address in the compose window. Replies default to the address the message was sent to.

Attachments

Add files by dragging them into the window on the Mac, or with the Files picker on iPhone and iPad. On the Mac you can also paste or drop a screenshot — it's added as an attachment.

Scheduled send

Not ready to send yet? Pick a date and time, and Boogie sends the message for you later.

Undo send

Boogie holds each message briefly after you press Send, so you can pull it back. Set the delay in Settings — off, or up to 30 seconds.

Send Again and drafts

Send Again reopens a message from your Sent mailbox as a fresh copy. Open any draft to carry on where you left off. Your signature is added automatically — see Signatures.

Signatures

Give each identity its own HTML signature. Edit them in Settings → Signatures with a rich editor — text, links, even an inline image — then assign one to each identity, so the right signature is added to every message you send.

Want the same signatures on all your devices? Turn on iCloud signature sync in Settings. It's off by default.

Calendar

Boogie includes a native JMAP calendar — no separate CalDAV account, same server, same sign-in.

  • Views — Day, Week, and Month.
  • Go anywhere — jump to any date, or snap back to today.
  • Events — create, edit, and delete events, including repeating events.
  • Colours New in 1.3 — pick a colour per calendar; it's saved to your server, so it follows you to every device.
  • Defaults — set a default event length, a default alert, and the day your week starts.

Invitations & RSVP

When an invitation arrives in your mail, reply Accept, Decline, or Maybe right from the message, and add the event to your calendar in a tap.

Server support

The calendar works wherever your server offers JMAP calendars — Stalwart Mail Server supports this today. Fastmail currently exposes calendars to other apps via CalDAV only, so calendar sync in Boogie isn't available for Fastmail accounts yet (mail works fully).

Vacation auto-reply

Going away? Turn on an auto-reply in Settings → Vacation: write a subject and message, and — if you like — set start and end dates so it switches itself on and off.

The auto-reply is stored on your server, so it keeps running even when Boogie is closed. It's available wherever your server supports vacation responses.

Notifications

Boogie can let you know when new mail arrives. Notifications are grouped by conversation, and tapping one opens the message straight away. When several arrive at once, you get a single summary instead of a stack of alerts.

Allow notifications when Boogie first asks, or any time afterwards from your device's system Settings. The unread count shows on the app badge.

Settings & accounts

Accounts

Add or remove accounts, and switch between them, in Settings → Accounts. If a mailbox ever looks wrong, Repair Mailboxes checks for duplicate or missing folders and fixes them. Where your server reports it, you'll also see your storage quota.

Reading and sync

Tune how mail looks and syncs: font size, message preview text, contact photos, and whether threads group into conversations. Sync depth controls how far back Boogie pulls — all mail, the last 6 months, or the last 3.

iCloud Keychain

Your account credentials sync securely across your Apple devices through iCloud Keychain — on by default, so a new device signs in without re-entering everything. Turn it off in Settings if you'd rather keep each device separate.

Keyboard shortcuts

Boogie is built for the keyboard on the Mac — and the same shortcuts work on iPad with a hardware keyboard. New in 1.3

j / kNext / previous message
/ Move selection (Mac)
Open message in its own window (Mac)
⌘RReply
⌘⇧RReply All
⌘FForward
Delete
⌃⌘AArchive
⌘⇧UToggle read / unread
⌘⇧LToggle flag
⌘NNew message — or new event in Calendar
⌘YSync now
? or ⌘/Show every shortcut

That last one matters: press ⌘/ in the app for the full, always-current list — Boogie ships more shortcuts than fit here.

Apple Watch

Boogie runs on Apple Watch — read and triage your inbox (mark read, flag, delete) and even compose a reply from your wrist. The watch syncs through your iPhone: sign in once on the phone and the watch follows.

Subscription & trial

Boogie is free to try for 14 days — every feature, on every platform, with no credit card to start.

When the trial ends, Boogie switches to read-only: your inbox stays readable and searchable and notifications keep arriving, but sending and calendar editing pause until you choose a plan. Nothing is deleted.

Pick an annual subscription or a one-time lifetime purchase — see pricing for the current plans. Already paid and setting up a new device? Use Restore Purchase in Settings. You can manage or cancel any time from your App Store subscriptions.

Troubleshooting

Can't sign in

  • Confirm your server offers JMAP. Boogie is JMAP-only by design and does not fall back to IMAP.
  • Fastmail: it needs an API token in the Bearer Token field (not a password), and the server set by hand to https://api.fastmail.com/jmap/session — Fastmail doesn't support automatic discovery. See Getting started.
  • Self-hosted: check that https://your-server/.well-known/jmap resolves, or enter the server address manually.

Mail isn't syncing

  • Check the device can reach your server (VPN-only servers need the VPN up).
  • Pull to refresh, or quit and relaunch — Boogie reconnects and resumes on its own.
  • Still stuck? Reset Cache & Resync in Settings re-pulls everything from the server.

Calendar is empty

Your server must support JMAP calendars — see Calendar. Fastmail accounts can't sync the calendar yet; mail works fully.

Restore Purchase isn't working

Make sure you're signed in with the same Apple Account you bought with, then try Restore Purchase in Settings again. You can check your plan in your App Store subscriptions.

Report a problem

Email support@boogie.digital with what you did, what you expected, what happened instead, your platform (Mac, iPhone, iPad, Watch) and OS version, and the Boogie version. Screenshots help. Boogie has no analytics — we genuinely can't see your problem unless you tell us.

Frequently asked questions

Which email servers does Boogie work with?

Boogie is a native JMAP 1.0 client. It works with any server that implements JMAP (RFC 8620) and, optionally, the JMAP Calendar specification (RFC 8621). Tested daily against Stalwart, Fastmail, and the reference implementation. No IMAP, no Exchange — if your provider speaks JMAP, Boogie connects.

My server isn't auto-discovered. What now?

Boogie uses the .well-known/jmap convention (RFC 8620 §2.2). If your server doesn't publish one, switch to 'Manual' in the account setup sheet and paste the JMAP session URL directly. Your provider's documentation or admin can tell you the URL.

How do I restore a previous purchase on a new device?

Open Settings → Subscription → Restore Purchases. Must be signed into the same Apple ID that made the original purchase. Family Sharing works for the Lifetime tier only.

The trial expired. What happens?

Read-only mode. You can still read mail, search, and browse your calendar. Compose, send, and calendar-write are paused until you subscribe (Yearly or Lifetime). Your mail and settings are untouched.

Where is my mail stored?

On your device (in a local SQLite database) and on your chosen JMAP server. Boogie is a transport — we don't run servers, we don't store your mail, we don't see your mail. Full details: privacy policy.

How do I report a bug?

Email support@boogie.digital with: (1) Boogie version (Settings → About), (2) your device and OS version, (3) steps to reproduce, (4) anything in the logs that looked relevant (Settings → Logs → Export). We read every report.

Install Boogie

  • App Store — Available on the Mac App Store, App Store for iPhone and iPad, and watchOS.