Integrating the React Native SDK

Integrating the MoEngage React Native plugin takes two steps: install the plugin and its native dependencies, then initialize the SDK. Choose the path that matches your project, React Native or Expo. Initialization comes in two forms. File-based initialization keeps configuration in native config files; manual initialization sets it in code on each platform.

React Native

SDK Installation

Page	What it covers
Framework Dependency	Install the plugin with npm and link native dependencies.
Android Build Configuration	Configure Android build settings and dependencies.
iOS	Set up iOS dependencies with CocoaPods or Swift Package Manager.

File Based Initialization

Page	What it covers
File Based Initialization	Configure the SDK through native config files.
Migration and Precedence	Move from manual initialization to file-based configuration.

Manual Initialization

Page	What it covers
Framework Initialization	Initialize the plugin in `App.js` or `App.ts` after the component mounts.
Android	Initialize the SDK in your Android `Application` class.
iOS	Initialize the SDK in your iOS `AppDelegate`.

Expo

Page	What it covers
Installation	Add the SDK with `npx expo install`.
Configure the MoEngage Expo SDK	Set plugin parameters and platform-specific initialization files.
Initialization	Initialize the SDK to activate tracking and messaging.

Advanced

Page	What it covers
JWT Authentication	Secure data collection by authenticating SDK requests with a JWT.

Review Limitations before you plan your integration. Some features are not supported in the plugin or need native implementation.

​React Native

​SDK Installation

​File Based Initialization

​Manual Initialization

​Expo

​Advanced

React Native

SDK Installation

File Based Initialization

Manual Initialization

Expo

Advanced