> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sendrealm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sendrealm Push Skill

> Help AI agents build Sendrealm push integrations.

Use `sendrealm-push` when an agent needs to add, review, or debug Sendrealm push notifications. The skill covers both sides of push: device registration in apps and backend sends from trusted code.

## What It Covers

* Choosing the right SDK for Web, React Native Expo, React Native bare, Android, or iOS.
* Configuring Firebase, APNs, or Web Push provider settings in Sendrealm.
* Initializing device SDKs with public Sendrealm Push App IDs.
* Requesting permission from a user action and linking users with `login`.
* Sending notifications from trusted backend code with `@sendrealm/sdk`.
* Using exactly one target style per send: `tokens`, `web_subscriptions`, `device_ids`, `contact_ids`, `external_ids`, `emails`, or `audiences`.
* Debugging registration, environment, credentials, diagnostics, and delivery issues.

## Use It

```text theme={null}
Use $sendrealm-push to add Sendrealm Web Push to my Vite app and send from my backend.
```

The skill should ask for the Sendrealm Push App ID, app environment, provider setup status, target identity, and final notification copy before generating production code.

## Guardrails

* Never expose `SENDREALM_API_KEY`, Firebase service account JSON, or APNs `.p8` keys in browser or mobile code.
* Distinguish Sendrealm `development` or `production` devices from iOS APNs `sandbox` or `production`.
* Treat audience sends as queued and direct device/contact/user sends as immediate.
* Do not promise device display. Provider accepted or sent counts are not proof that a notification appeared on the device.
* Use diagnostics before changing backend targeting logic.

## Source Docs

* [SDK Overview](/sdks/overview)
* [JavaScript SDK](/sdks/javascript)
* [React Web Push SDK](/sdks/react)
* [React Native Expo SDK](/sdks/react-native-expo)
* [React Native Bare SDK](/sdks/react-native-bare)
* [Android SDK](/sdks/android)
* [iOS SDK](/sdks/ios)
* [Mobile Push Credentials](/tutorials/mobile-push-credentials)
* [Send Push Notification API](/api-reference/endpoint/send-push-notification)
