Push Notifications

Receive real-time fleet alerts through browser push notifications and the in-app notification panel with categorised tabs, per-item dismiss, and database-backed persistence.

Push Notifications

Yipii IoT delivers fleet alerts and system notifications through two complementary channels: browser push notifications that reach you even when the app is closed, and an in-app notification panel that organises everything into filterable categories. Both channels work together so you never miss a critical event.

The Notification Panel

The notification panel is your central hub for all notifications. Access it by clicking the bell icon in the header toolbar. When you have unread notifications, a red badge on the bell shows the count.

The panel opens as a slide-over sheet from the right side of the screen and contains four tabs for filtering notifications by category:

• All -- Every notification across all categories, sorted newest first
• Alerts -- Alert-type notifications triggered by fleet events such as speeding, geofence violations, power cuts, tampering, and other configured alerts
• Events -- Event-type notifications for operational events such as document expiry warnings, service reminders, SIM data usage, and subscription notices
• Info -- Informational notifications from the system, including account activity (password changes, login from new device), system announcements, and platform tips

Each notification displays its title, a description of the triggering event, how long ago it occurred, and (where applicable) the associated vehicle name. Notifications are colour-coded by severity:

• High severity (red icon) -- Power cut, tampering, SOS, accident, jamming, DTC detected
• Medium severity (amber icon) -- Overspeed, harsh braking, harsh acceleration, GPS signal lost, temperature alerts, idle, untimely movement
• Low severity (yellow/default icon) -- Geofence events, ignition changes, signal recovery, and other routine notifications

Dismissing Notifications

Each unread notification has its own dismiss button (an X icon) that appears when you hover over it. Click the X to mark that individual notification as read without affecting the others.

To clear everything at once, click the Mark all read button in the top-right corner of the panel. This marks all unread notifications as read across every category.

Clicking on a notification body also marks it as read and can navigate you to the relevant page for further action.

Loading Older Notifications

The panel loads your most recent notifications first. If you have more history available, a Load more button appears at the bottom of the list. Click it to fetch the next batch of older notifications.

Database-Backed Notifications

Notifications are persisted in the database, which means they survive browser refreshes and are available across sessions. When you open the notification panel, it fetches your notification history from the server and merges it with any real-time notifications received via WebSocket during the current session.

The notification system includes several features that keep the panel useful rather than noisy:

• Deduplication -- If the same notification (identical title and description) arrives within 30 seconds, the duplicate is suppressed so you see each event only once
• Digest mode -- Similar notifications can be batched together to prevent your panel from being flooded during high-activity periods
• Auto-resolve -- Certain notifications clear automatically when the underlying condition resolves (for example, a GPS signal lost notification may auto-resolve when the signal is re-established)
• Capped history -- The client retains the most recent 100 notifications locally, with older entries available from the server via pagination

Push Notifications (Browser)

Push notifications use the Web Push standard built into modern browsers. When you enable push notifications, your browser creates a secure subscription channel between your device and Yipii IoT. When an alert triggers, the server sends the notification through this channel, and your browser displays it as a system notification -- complete with sound, vibration (on mobile), and a clickable link back to the relevant page.

Push notifications are:

• Free and unlimited -- no SMS credits needed
• Instant -- delivered within seconds of the triggering event
• Cross-platform -- work on desktop (Chrome, Edge, Firefox) and mobile (Chrome on Android, Safari on iOS 16.4+)
• Persistent -- appear even when the browser is closed (on supported platforms)

Enabling Push Notifications

There are two ways to enable push notifications: through the automatic prompt that appears after login, or manually through Settings.

Via the Prompt Banner

After you log in, a notification banner appears at the bottom of the screen after 30 seconds:

Enable Notifications -- Get instant alerts even when the app is closed

Click Enable to subscribe. Your browser will ask you to confirm permission -- click Allow in the browser dialog to complete setup.

If you dismiss the banner, it reappears after 7 days. Once you enable push notifications, the banner does not appear again.

Via Settings

You can enable or disable push notifications at any time from your account settings:

1. Navigate to Settings from the header menu
2. Open the Notifications tab
3. Find the Notifications card with the push toggle
4. Click Enable (if notifications have not been set up yet) or toggle the switch on/off

The card shows your current status:

• Enable button -- notifications have not been set up yet; clicking this triggers the browser permission dialog
• Toggle on -- you are receiving push notifications on this device
• Toggle off -- push notifications are paused; toggle back on to resume
• Notifications blocked -- you previously denied permission in your browser; see Troubleshooting below to fix this

Alert Push Notifications

Alert push notifications include the alert name, a description of the triggering event, and the alert priority. Notifications are styled by severity:

• Critical (red) -- SOS, power cut, tampering, accident detection, vehicle removal. These require interaction and stay on screen until you dismiss them. Your device vibrates with a strong pattern.
• Warning (amber) -- Idle too long, maintenance required, harsh acceleration or braking. A moderate vibration pattern draws your attention.
• Informational (default) -- Ignition changes, speed alerts, temperature, geofence events, GPS signal changes, daily health check. A brief vibration notifies without being intrusive.

Clicking a push notification opens the Yipii IoT app and navigates to the relevant page where you can review and take action.

Broadcast Notifications

Occasionally, you may receive broadcast notifications from Yipii for:

• Release updates -- new features and platform improvements
• Maintenance windows -- scheduled downtime or system maintenance
• Feature announcements -- tips about new capabilities

Maintenance broadcasts stay on screen until dismissed. Other broadcasts disappear after the default notification timeout.

Notification Settings

The Settings > Notifications tab is where you control all notification preferences for your account:

• Push Notifications -- Enable or disable browser push notifications for this device
• Maintenance Notifications -- Configure email notifications for service reminders and vehicle maintenance events

These settings apply to the current browser and device. Changing preferences on one device does not affect other devices where you are signed in.

Per-Device Subscriptions

Push notification subscriptions are specific to each browser and device. If you use Yipii IoT on both your laptop and phone, you need to enable push notifications on each device separately. This also means you can enable notifications on your work computer while keeping them off on personal devices, or vice versa.

Unsubscribing on one device does not affect other devices.

Adding Push to Existing Alerts

If you created alerts before push notifications were available, you can add push delivery to them:

1. Navigate to Alerts from the operations menu
2. Click the alert you want to update
3. In the notification channels section, enable Push
4. Click Save

The alert immediately begins sending push notifications in addition to any other channels you have enabled.

PWA Badge Count

When you install Yipii IoT as a Progressive Web App (added to your home screen or taskbar), the app icon displays a badge with the current unread notification count. This badge updates automatically as new notifications arrive and as you dismiss them from the panel.

Troubleshooting

Not receiving push notifications

1. Check subscription status -- go to Settings > Notifications and verify the Push Notifications toggle is on
2. Check alert configuration -- ensure the specific alert has the Push channel enabled
3. Check browser -- push notifications require a modern browser (Chrome 50+, Firefox 44+, Edge 17+, Safari 16.4+)
4. Check system settings -- your operating system may have its own notification settings that can block browser notifications. On macOS, check System Settings > Notifications. On Windows, check Settings > Notifications.
5. Try re-subscribing -- toggle push notifications off and back on in Settings

Browser permission was denied

If you accidentally clicked "Block" when the browser asked for notification permission, you need to reset it in your browser settings:

Chrome:

1. Click the lock icon (or tune icon) in the address bar
2. Find "Notifications" in the permissions list
3. Change from "Block" to "Allow"
4. Reload the page and enable push notifications in Settings

Firefox:

1. Click the lock icon in the address bar
2. Click "Connection secure" then "More Information"
3. Go to the Permissions tab
4. Find "Send Notifications" and change to "Allow"

Safari (macOS):

1. Open Safari > Settings > Websites > Notifications
2. Find the Yipii IoT site and change to "Allow"

Edge:

1. Click the lock icon in the address bar
2. Find "Notifications" and change to "Allow"

After resetting the permission, return to Settings > Notifications in Yipii IoT and click Enable on the Notifications card.

Push notifications work on laptop but not on phone

Each device requires its own subscription. Open Yipii IoT on your phone's browser, go to Settings > Notifications, and enable push notifications there.

On iOS, push notifications require:

• Safari 16.4 or later (iOS 16.4+)
• The app must be installed as a PWA (added to home screen) -- Safari does not support push for regular browser tabs

Notifications appear but with no sound

Check your device's Do Not Disturb or Focus mode settings. Also verify that browser notification sounds are enabled in your operating system's notification settings.

Notification panel shows no notifications after refresh

If the panel appears empty immediately after a page refresh, wait a moment for the backend to respond. Notifications are fetched from the server on each page load and may take a second to appear. The panel also polls the server every 60 seconds and immediately refreshes when a new real-time alert arrives via WebSocket.

What's Next?

• Alerts -- Configure the fleet alerts that trigger push notifications
• Account Settings -- Manage email, SMS, and in-app notification preferences
• Billing -- Push notifications are free, no credits needed unlike SMS