Introduction
The Mapp Engage React Native Plugin connects the Mapp Engage mobile SDK for Android and iOS to a unified JavaScript API. Platform-specific behavior is handled internally — the same method call routes to the correct native implementation on each platform.
The plugin uses auto-linking and targets React Native 0.84 and above. Since 2.0.0, it also supports Expo through a config plugin, and is verified with the React Native New Architecture enabled.
Key Capabilities
Push notification delivery and opt-in management on Android (FCM) and iOS (APNs)
In-app message triggering and persistent inbox (iOS)
Location-based notifications via geofencing
Device identity management via alias, custom attributes, and tags
Custom event tracking to the Mapp backend
Deep link handling from push notifications
Requirements
Dependency | Minimum version |
|---|---|
React Native | 0.84 |
React | 19.2.3 |
Mapp Android SDK | 7.1.2 |
Mapp iOS SDK | 6.1.3 |
iOS deployment target | 15.1 (tested baseline 16.4) |
JDK (Android builds) | 21 |
Building with Expo? See the Expo Integration Guide for the config plugin setup and additional requirements.
Related Content
Get Started — installation and initialization
Expo Integration Guide — config plugin setup for Expo apps
Push Notifications — platform-specific push setup, deep links, and geofencing
In-App Messaging — triggered messages, inbox, and rich messages
User Data — alias, attributes, tags, and custom events
API Reference — complete method list
MappPushHelper Reference — native Android API for custom Firebase services
Breaking Changes in 2.0.0 and Migrating from 1.4.2 to 2.0.0 — upgrading from 1.4.2
Changelog — version history