---
title: "React Native"
slug: "react-native"
status: "update"
updated: 2026-09-03T14:21:49Z
published: 2026-09-03T14:21:49Z
canonical: "docs.mapp.com/react-native"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# React Native

## 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](/docs/en/expo-integration-guide-react-native-engage) for the config plugin setup and additional requirements.

## Related Content

- [Get Started](/docs/en/getting-started-react-native-engage) — installation and initialization
- [Expo Integration Guide](/docs/en/expo-integration-guide-react-native-engage) — config plugin setup for Expo apps
- [Push Notifications](/docs/en/push-notifications-react-native-engage) — platform-specific push setup, deep links, and geofencing
- [In-App Messaging](/docs/en/in-app-messaging-react-native-engage) — triggered messages, inbox, and rich messages
- [User Data](/docs/en/user-data-react-native-engage) — alias, attributes, tags, and custom events
- [API Reference](/docs/en/api-reference-react-native-engage) — complete method list
- [MappPushHelper Reference](/docs/en/mapppushhelper-reference-react-native-engage) — native Android API for custom Firebase services
- [Breaking Changes in 2.0.0](/docs/en/breaking-changes-2-0-0-react-native-engage) and [Migrating from 1.4.2 to 2.0.0](/docs/en/migrating-1-4-2-to-2-0-0-react-native-engage) — upgrading from 1.4.2
- [Changelog](/docs/en/react-native-changelog) — version history