React Native Expo SDK

Use the Sendrealm React Native SDK in Expo apps that can include native code. That means Expo prebuild, expo run, EAS development builds, and production builds. Expo Go is not supported because mobile push requires native code. If your React Native app already owns native android and ios projects without Expo prebuild, use React Native Bare SDK.

Requirements

Expo project using development builds or prebuild.
Android device or emulator with Google Play services.
Physical iOS device for APNs testing.
A Sendrealm app ID from the dashboard.
Firebase credentials uploaded for Android delivery.
APNs credentials uploaded for iOS delivery.
Push Notifications enabled for the iOS Bundle ID in Apple Developer.

Setup Order

Upload Firebase and APNs credentials in Sendrealm.
Install @sendrealm/react-native.
Add the Sendrealm Expo plugin to app.json or app.config.js.
Add Android google-services.json.
Configure iOS push capabilities.
Run Expo prebuild or create an EAS build.
Initialize Sendrealm from JavaScript.
Ask for notification permission after explaining the value to the user.
Call login when the user signs in.
Send test pushes on Android and iOS.

Install

npx expo install @sendrealm/react-native

Configure The Plugin

Add the Sendrealm plugin to app.json or app.config.js:

{
  "expo": {
    "plugins": [
      [
        "@sendrealm/react-native",
        {
          "android": {
            "googleServicesFile": "./google-services.json",
            "notificationIcon": "ic_stat_sendrealm",
            "notificationColor": "#111827"
          },
          "ios": {
            "apnsEnvironment": "sandbox",
            "enableBackgroundRemoteNotifications": true,
            "notificationServiceExtension": true
          }
        }
      ]
    ],
    "extra": {
      "sendrealmAppId": "YOUR_SENDREALM_APP_ID",
      "sendrealmPushEnvironment": "development",
      "sendrealmApnsEnvironment": "sandbox"
    }
  }
}

Do not put Sendrealm API keys, Firebase service account JSON, or APNs .p8 files in Expo config. Provider private keys belong in the Sendrealm dashboard.

Android Setup

Generate google-services.json from Firebase and save it in your Expo project. Point the plugin at the file:

{
  "android": {
    "googleServicesFile": "./google-services.json"
  }
}

During prebuild, the plugin copies it into the Android app. Make sure the Firebase Android package name matches the package Expo builds, usually expo.android.package.

iOS Setup

In Apple Developer:

Open Certificates, Identifiers & Profiles.
Open Identifiers.
Select the App ID for the Bundle ID in your Expo config.
Enable Push Notifications.
Save the App ID changes.

In Expo config:

Set ios.apnsEnvironment to sandbox for development builds or production for TestFlight and App Store builds.
Set ios.enableBackgroundRemoteNotifications to true only if you send silent/background pushes.
Set ios.notificationServiceExtension to true if you send rich image notifications.

Then rerun prebuild or create a new EAS build. See Mobile Push Credentials for Firebase and APNs setup.

Prebuild And Run

Generate native projects and run locally:

npx expo prebuild --platform android
npx expo run:android

npx expo prebuild --platform ios
npx expo run:ios --device

Use --device for iOS push testing.

Build With EAS

Build development clients with EAS:

npx eas build --profile development --platform android
npx eas build --profile development --platform ios

Initialize

Read values from Expo config and initialize once:

import Constants from "expo-constants";
import { useEffect } from "react";
import Sendrealm from "@sendrealm/react-native";

export default function App() {
  useEffect(() => {
    const extra = Constants.expoConfig?.extra ?? {};

    void Sendrealm.initialize({
      appId: extra.sendrealmAppId,
      environment: extra.sendrealmPushEnvironment ?? "development",
      autoRequestPermission: false,
      apnsEnvironment: extra.sendrealmApnsEnvironment ?? "sandbox",
    });
  }, []);

  return null;
}

Use production for production-targeted app builds. Most apps should keep autoRequestPermission: false and ask permission after an in-app explanation.

Ask For Permission

await Sendrealm.requestPermission();

Check status:

const status = await Sendrealm.getPermissionStatus();
const allowed = await Sendrealm.hasNotificationPermission();

Link A Signed-In User

await Sendrealm.login("user-123", "user@example.com");

Tags And Events

Use tags for app-observed preferences, state, and behavior:

await Sendrealm.addTags({
  plan: "pro",
  onboardingComplete: true,
});

Track app events:

await Sendrealm.trackEvent("checkout_started", {
  product_id: "sku_123",
  price: 29,
});

Call login before setting user tags.

Rich iOS Media

Rich image notifications require a Notification Service Extension. Enable it in the plugin:

{
  "ios": {
    "notificationServiceExtension": true
  }
}

Then rerun prebuild or create a new EAS build.

Android Notification Icons

Android status bar icons should be simple drawable resources, usually monochrome. If you set:

{
  "android": {
    "notificationIcon": "ic_stat_sendrealm"
  }
}

The native Android project must contain a matching drawable resource such as res/drawable/ic_stat_sendrealm.xml.

Diagnostics

Use support diagnostics while testing:

const diagnostics = await Sendrealm.getSupportDiagnostics();
console.log(JSON.stringify(diagnostics, null, 2));

Confirm diagnostics show:

A device ID.
Token presence.
Expected permission status.
Subscribed state unless the user opted out.
SDK version.
No unexpected SDK error.

Troubleshooting

Symptom	What to check
Expo Go does not work	Build a development client or production app because native code is required.
Android token is missing	Use a Google Play device or emulator and verify the Firebase Android package name.
iOS push does not arrive	Use a physical device and verify APNs environment, Bundle ID, Team ID, Key ID, and `.p8` key in Sendrealm.
iOS entitlement is missing	Enable Push Notifications on the Apple Developer App ID, rerun prebuild, and rebuild the app.
Plugin changes do not appear	Rerun `expo prebuild` or create a fresh EAS build.
Notifications are delayed	Check Android power management, FCM priority, iOS APNs priority, Focus settings, and notification permissions.
Some pushes are missing	Check stale tokens, disabled channels, offline devices, and provider diagnostics.
Rich images do not attach	Confirm `notificationServiceExtension` is enabled and the app has been rebuilt.
Tags return `ContactNotLinked`	Call `login(userId, email)` before tags.

Get Started

Tutorials

SDKs

Agent Skills

Requirements

Setup Order

Install

Configure The Plugin

Android Setup

iOS Setup

Prebuild And Run

Build With EAS

Initialize

Ask For Permission

Link A Signed-In User

Tags And Events

Rich iOS Media

Android Notification Icons

Diagnostics

Troubleshooting

​Requirements

​Setup Order

​Install

​Configure The Plugin

​Android Setup

​iOS Setup

​Prebuild And Run

​Build With EAS

​Initialize

​Ask For Permission

​Link A Signed-In User

​Tags And Events

​Rich iOS Media

​Android Notification Icons

​Diagnostics

​Troubleshooting

​Related Pages

Requirements

Setup Order

Install

Configure The Plugin

Android Setup

iOS Setup

Prebuild And Run

Build With EAS

Initialize

Ask For Permission

Link A Signed-In User

Tags And Events

Rich iOS Media

Android Notification Icons

Diagnostics

Troubleshooting

Related Pages