Bare React Native Recipe

A bare React Native app (no Expo modules) usually already has Firebase wired in for Android and an APNs delegate for iOS. Both tokens register with the same endpoint.

Tokens

Android — FCM token (@react-native-firebase/messaging):

import messaging from "@react-native-firebase/messaging";

const fcmToken = await messaging().getToken();

iOS — APNs token:

const apnsToken = await messaging().getAPNSToken(); // hex string, null until APNs registers

getAPNSToken() resolves only after APNs has delivered the token — subscribe to messaging().onTokenRefresh() and register again whenever either token changes.

No Firebase on iOS? Keep using the APNs delegate directly: application(_:didRegisterForRemoteNotificationsWithDeviceToken:) gives you the hex token (see the Swift recipe for the delegate details).

Register

import { Platform } from "react-native";

export async function registerUniversalDevice({ appId, appToken, subscriberId, deviceId }) {
  const tokens =
    Platform.OS === "ios"
      ? { apnsToken: await messaging().getAPNSToken() }
      : { fcmToken: await messaging().getToken() };

  const res = await fetch("https://app.nativenotify.com/api/universal/device/register", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      appId,
      appToken,
      deviceId,      // persisted per install — see Device Registration
      platform: Platform.OS,
      subscriberId,  // omit for a mass device
      tokens,
    }),
  });
  return res.json();
}

Call it on launch and from both token-refresh listeners. Re-registering is an upsert: same device, refreshed token.

Required project setup

• Android: the app's google-services.json (the Firebase project whose service account is saved as the app's credentials in Native Notify).
• iOS: APNs capability + push entitlement, an aps-environment profile that matches the build, and the app's .p8 key saved in Native Notify — Apple sends to the bundle id, so the credential's bundle id must match.
• Notification permission must be granted before any token arrives.

Next steps

• Device Registration and Push Credentials.
• Verify Delivery — test-send to the device you just registered.
• Want to skip the native wiring? The native-notify SDK works in bare React Native too — it adds Expo modules for the push token plumbing (see Installation).