PushEngage for React Native
Add push notifications and in-app messages to a React Native app on Android and iOS with the PushEngage React Native SDK. One npm package with TypeScript and JavaScript support covers both platforms, and campaigns run from the PushEngage dashboard.
What you can do with React Native
One package for Android and iOS
A single JavaScript API sits on top of native Swift and Kotlin code, delivering through Firebase Cloud Messaging on Android and Apple Push Notification service on iOS.
Deep links and cold-start taps
A listener receives the deep link and notification data when a notification is tapped, and a separate call returns the notification that launched the app.
Permission and subscribe in one call
Requesting notification permission also subscribes the user when they allow it, so there is no separate subscribe step.
Segments, attributes, and triggered campaigns
Add subscribers to static or dynamic segments, set custom attributes, and send trigger events, goals, and price drop or inventory alerts from JavaScript.
In-app messages
Show banners, modals, and full-screen messages designed on the dashboard. No JavaScript-side setup is needed once the SDK has your App ID.
Bare workflow and Expo development builds
Bare React Native projects are fully supported. Expo projects work through a development build, covered on the Expo page of this directory.
How to set it up
- Install @pushengage/pushengage-react-native with npm or yarn.
- For Android, set up Firebase Cloud Messaging and enter your Sender ID and Service Account JSON in PushEngage under Site Settings > Installation > Android SDK.
- For iOS, add Push Notifications and Background Modes in Xcode, and upload your APNs certificate under the iOS SDK tab in PushEngage.
- Add a Notification Service Extension to the iOS project. A Notification Content Extension is optional.
- Add the App Groups capability to the main app target and the extension.
- Initialize the SDK with your App ID in the root index.js before the app is registered, and add the PushEngage lines to AppDelegate.mm for iOS.
- Run on a physical device and send a test from Campaign > Push Broadcasts.
Full guide: React Native quickstart
Good to know
- App push and this SDK are listed on every PushEngage plan, including the free plan. Goal tracking, custom triggered campaigns, and in-app messages need a paid plan.
- The current SDK needs React Native 0.78 or later with the New Architecture (Turbo Modules). The docs point older React Native versions to an earlier SDK release.
- Android needs a Firebase project, and iOS needs an Apple Developer account with an App ID and an APNs certificate.
- The SDK includes native code, so it does not run in Expo Go. Use a bare project or an Expo development build.
- Native setup is still required on both sides: Gradle and Firebase for Android, Xcode capabilities and a Notification Service Extension for iOS.
- If the iOS build fails on @import with C++ modules disabled, add -fcxx-modules to Other C++ Flags in Xcode.
About this connection
- PushEngage builds and maintains this SDK. It is not a partnership with Meta or the React Native project.
- The source is public on GitHub in the awesomemotive/pushengage-react-native repository under the MIT license.
- The package is published on npm under the @pushengage scope.
- PushEngage also publishes open-source Agent Skills, so an AI coding agent such as Claude Code or Cursor can run the integration and diagnose a broken setup.
PushEngage Partner Directory
Ready to add push to your React Native app? Start with the setup guide.
PushEngage has a free plan, so you can install it and send your first campaign before you pay anything.