Push notifications

Enabling push

On first launch the app prompts for notification permission. If you declined and want to enable later:

• iOS: Settings → Notifications → SuperMail → Allow Notifications.
• Android: Settings → Apps → SuperMail → Notifications → Allow.

The app registers a push token with the backend on sign-in (via Expo’s push service). Once that token is registered, new mail can deliver as a push notification.

Foreground vs background

• App in the background or closed: notifications appear in the system tray as you’d expect.
• App in the foreground: notifications are surfaced as in-app banners; the inbox refreshes silently without opening a system notification.

Turning push off

Use the system notification toggle for the SuperMail app:

• iOS: Settings → Notifications → SuperMail → Allow Notifications (off).
• Android: Settings → Apps → SuperMail → Notifications → toggle off.

There are no per-account notification preferences, VIP filters, Focused-only filters, quiet hours, or thread grouping in the app today. If you want any of these, system-level Do Not Disturb is the right tool for now.

How push works under the hood

SuperMail uses Expo Push Notifications, which routes through APNs on iOS and FCM on Android. When mail arrives:

1. Backend processes the new message.
2. Backend sends a push payload to Expo, which delivers to APNs / FCM.
3. The device shows the notification.

Troubleshooting

• Not getting push on iOS - toggle Airplane mode off, then on. APNs sometimes loses the device token after long offline periods.
• Not getting push on Android - check battery optimization settings. Aggressive battery savers (especially on Samsung, Xiaomi) can kill background notifications.
• Token not registering - sign out and back in to force a fresh push-token registration.