AddThisFeature

OneSignal Push Notifications

Send push notifications to the right devices, with user preferences respected.

involved Sales & Marketing Tools

What it adds

A push delivery path through OneSignal covering subscription registration, audience targeting, per-channel preferences, and delivery outcomes recorded against the app's own records.

What your agent is told to do

5
  1. 1

    Find the events the app already notifies on by email or in-app, and treat push as another channel for those same events rather than a separate notification system with its own triggers.

  2. 2

    Record the link between a push subscription and an account on the server, established at sign-in and severed at sign-out, so a device that changes hands does not keep receiving the previous user's notifications.

  3. 3

    Hold the provider credentials server-side and send every message from the app's existing background-job system, so a slow or failing provider never blocks a web request.

  4. 4

    Ask for the browser or device permission at a moment the user has chosen, after they have enabled push in settings, and never on first page load. A denied permission is usually permanent and cannot be re-prompted.

  5. 5

    Do not treat the provider's segments as the source of truth for who should be notified. Decide the audience from the app's own data and preferences, then address the send to specific subscriptions, or overlapping segments will deliver the same event two or three times.

Edge cases it handles

8
  • A shared or borrowed device can accumulate subscriptions for more than one account. Bind a subscription to the account that was signed in when it was created and clear it at sign-out, rather than merging every subscription seen on that device into one user.
  • Users who have muted a category, or muted notifications entirely, must be filtered out before the send is composed. Push must obey the same per-channel preferences and quiet hours as email, not bypass them.
  • The provider will report subscriptions that have expired, been revoked, or belong to an uninstalled app. Mark those inactive on the next failure rather than retrying them forever, and treat a duplicate registration for the same device as a replacement rather than a second recipient.
  • A notification that deep-links into the app must re-check permission when it is opened. The recipient may have lost access to the record, or the record may have been deleted, so the destination needs a graceful fallback instead of an error page.
  • The same event reaching a user through two overlapping audiences must be collapsed into one delivery. Deduplicate on the event identifier and the recipient before anything is handed to the provider.
  • When the provider is unreachable or rate-limits the send, queue and retry with increasing delays rather than dropping the notification, and stop retrying anything time-sensitive once it is no longer worth delivering.
  • Notification content is visible on a lock screen. Keep names, amounts, and message bodies out of the payload unless the user has opted into showing them.
  • Some browsers and platforms do not support push at all. The settings screen must say so plainly instead of offering a toggle that silently does nothing.

Definition of done

9
  • Push subscriptions are bound to the account that registered them and are released at sign-out.
  • Per-category and per-channel preferences are applied before a send is composed, and muted users receive nothing.
  • Expired, revoked, and duplicate subscriptions are marked inactive after provider failures rather than retried indefinitely.
  • A single event produces exactly one notification per recipient regardless of how many audiences match.
  • Opening a notification for a deleted or now-forbidden record lands on a clear message rather than an error.
  • Provider outages and rate limits are absorbed by retries in the background job system with no failed web requests.
  • No provider credential is present in anything served to the browser.
  • The feature matches the existing design system.
  • No existing functionality is broken.

Related features

How it works

  1. 1

    Copy the link

    Grab the Markdown instruction URL for this feature.

  2. 2

    Give it to your AI

    Paste it into Claude Code, Cursor, v0, Lovable — whatever you build with.

  3. 3

    It inspects, then implements

    Your agent reads your existing app first, then adds the feature to fit it.

Works with your stack

These instructions are written to adapt. They tell the agent to detect your framework, match your existing design system, and reuse what you already have — rather than assuming a particular stack.

Need it tighter than that? Customize the feature and tell it exactly what you're running.