Push Notifications

Cloud Only

Push notifications are available in the Cloud version only.

Push notifications let ADHDev Cloud alert you even when the dashboard tab is closed or your device is in the background.

What They Are For

Push is most useful for events that need fast attention:

• approval requests
• completed tasks
• agent errors
• machine disconnect alerts

These alerts are configured from the Notifications page alongside browser notifications and provider-level alert preferences.

Where They Work

ADHDev uses the Web Push stack built into the browser and operating system. In practice, the supported paths are:

• ✅ Desktop (Chrome, Edge, Firefox, Safari macOS)
• ✅ Android (Chrome)
• ✅ iOS (Safari PWA — iOS 16.4+)

How To Enable Push

Desktop And Android

1. Open Notifications in the dashboard.
2. Turn on global notifications if they are off.
3. Turn on Push Notifications.
4. Allow notification permission when your browser prompts.

Once push is enabled, ADHDev can also show your registered devices and let you send a test notification.

iOS (PWA Required)

On iPhone and iPad, push only works from the installed PWA:

1. Open adhf.dev in Safari
2. Tap Share (⬆️) → Add to Home Screen → Add
3. Open the installed ADHDev app from your home screen
4. Open Notifications in ADHDev
5. Tap "Allow" when iOS asks for notification permission

WARNING

• iOS requires 16.4 or later
• Push does not work from a normal Safari tab
• If notifications do not appear, also check iOS Settings → Notifications → ADHDev

What You Can Manage

The Notifications page is more than a single on/off switch. It can include:

• global notification enablement
• browser notifications
• push notifications
• a device list for registered push subscriptions
• a test push button
• per-event preferences such as completion, approval, disconnect, and error alerts

These notifications are driven by the cloud account path. Standalone/self-hosted does not provide hosted push delivery.

How It Works

1. Your browser creates a push subscription.
2. ADHDev Cloud stores that subscription on your account.
3. When a relevant event happens, the cloud service sends a push message to that device.
4. The OS or browser displays the notification.
5. Opening the notification takes you back into the dashboard flow.

Multiple devices can be registered to the same account.

Plan Limits

Plan	Daily Notifications
Free	30
Pro	Unlimited
Team	Unlimited
Enterprise	Unlimited

Disabling

Turn off Push Notifications in the Notifications page, or revoke permission in your browser or OS settings.

On iOS you can also disable them from Settings → Notifications → ADHDev.

Troubleshooting

• If push is marked unsupported, switch to a supported browser or install the iOS PWA.
• If permission is denied, re-enable notifications in browser or site settings first.
• If a device stopped receiving alerts, check the registered device list in Notifications.
• If you use self-hosted, push delivery is not part of that path.