--- id: "getting-started/installation/reactnative" title: "React Native" description: "This tutorial shows you how to install the RevenueCat SDK in your React Native app. By the end, you'll have the SDK added to your project with npm or yarn, verified with a successful build, and be ready to configure the SDK." permalink: "/docs/getting-started/installation/reactnative" slug: "reactnative" version: "current" original_source: "docs/getting-started/installation/reactnative.mdx" --- > **AI agents:** This is the Markdown version of a RevenueCat documentation page. For the complete documentation index, see [llms.txt](https://www.revenuecat.com/docs/llms.txt). This tutorial shows you how to install the RevenueCat SDK in your React Native app. By the end, you'll have the SDK added to your project with npm or yarn, verified with a successful build, and be ready to [configure the SDK](https://www.revenuecat.com/docs/getting-started/configuring-sdk). ## Prerequisites You need the following before you start: - A [RevenueCat account](https://app.revenuecat.com/). - A [project](https://www.revenuecat.com/docs/projects/overview) in your RevenueCat account. - A React Native app (version 0.73 or later) open in your editor. Using Expo? See [Using RevenueCat with Expo](https://www.revenuecat.com/docs/getting-started/installation/expo) instead — Expo projects install the same SDK with Expo's own tooling. ## 1. Install the SDK [![Release](https://img.shields.io/github/v/release/RevenueCat/react-native-purchases?filter=!*beta*)](https://github.com/RevenueCat/react-native-purchases/releases) The SDK ships as the `react-native-purchases` package, and React Native links it to the native projects automatically. Install `react-native-purchases-ui` alongside it for UI components like [Paywalls](https://www.revenuecat.com/docs/tools/paywalls) and [Customer Center](https://www.revenuecat.com/docs/tools/customer-center). 1. Install both packages: **npm** ```shell npm install --save react-native-purchases react-native-purchases-ui ``` **yarn** ```shell yarn add react-native-purchases react-native-purchases-ui ``` The React Native CLI installs the SDK's iOS native dependencies (CocoaPods) automatically the first time you run the app, so there's nothing else to install. ### Other installation methods Manual linking (legacy React Native versions) Auto-linking was introduced in React Native 0.60, and the `react-native link` command was removed from the CLI in 0.69. Only use manual linking on legacy projects that predate auto-linking, with an SDK version that supports your React Native version. After installing the `react-native-purchases` package, link the library to the native projects: **Shell** ```shell react-native link react-native-purchases ``` ## 2. Import the SDK 1. Import `Purchases` in any source file that uses the SDK: ```jsx import Purchases from 'react-native-purchases'; ``` 2. Run the app (`npx react-native run-ios` or `npx react-native run-android`). If the app builds and launches with the import in place, the SDK is installed correctly. ## Additional iOS setup When you're ready to distribute on the App Store, enable the In-App Purchase capability in Xcode — see the [iOS install guide](https://www.revenuecat.com/docs/getting-started/installation/ios#3-enable-the-in-app-purchase-capability). Nothing else is needed to build and test with the [Test Store](https://www.revenuecat.com/docs/test-and-launch/sandbox/test-store). ## Additional Android setup ### Set your Activity's launchMode New React Native projects set the main Activity's `launchMode` to `singleTask`, which can cancel purchases. Depending on your user's payment method, Google Play may ask them to verify the purchase in another app, such as their banking app. This means they have to background your app during the purchase, and backgrounding your app cancels the purchase if `launchMode` is set to anything other than `standard` or `singleTop`. In `android/app/src/main/AndroidManifest.xml`, set the `launchMode` of the Activity that triggers purchases to `standard` or `singleTop`: **AndroidManifest.xml** ```xml ``` For details on the options, see Android's [launchMode documentation](https://developer.android.com/guide/topics/manifest/activity-element#lmode). R8 build failures with react-native-purchases-ui If you encounter build failures related to R8 (Android's code shrinker) when using `react-native-purchases-ui`, you may see errors like: ``` Execution failed for task ':app:mergeExtDexDevDebug'. > Could not resolve all files for configuration ':app:devDebugRuntimeClasspath'. ``` This issue occurs due to a bug in earlier versions of Android Gradle Plugin (AGP) that affects R8 dependency resolution. To fix this, add the following to your project-level `build.gradle` file (not `app/build.gradle`): **build.gradle (project level)** ```gradle buildscript { repositories { mavenCentral() maven { url = uri("https://storage.googleapis.com/r8-releases/raw") } } dependencies { classpath("com.android.tools:r8:8.1.44") } } ``` This solution forces the use of a specific R8 version that resolves the dependency conflicts. For more details, see the [Google Issue Tracker](https://issuetracker.google.com/issues/342522142#comment8). ## Other stores The steps above cover the App Store and Google Play. Building your React Native Android app for the Amazon Appstore or the Galaxy Store requires additional configuration. Amazon Appstore 1. Configure the SDK with your Amazon Appstore API key and set `useAmazon` to `true`: ```jsx import Purchases from 'react-native-purchases'; Purchases.configure({ apiKey: , useAmazon: true, }); ``` 2. Add Amazon's `.pem` public key to your project by following [Amazon's Appstore SDK configuration guide](https://developer.amazon.com/docs/in-app-purchasing/integrate-appstore-sdk.html#configure_key). Galaxy Store Galaxy Store support is available in React Native SDK versions `10.3.0` and above. 1. Install the Galaxy Store add-on package in addition to `react-native-purchases`: **npm** ```shell npm install --save react-native-purchases-store-galaxy ``` **yarn** ```shell yarn add react-native-purchases-store-galaxy ``` 2. Configure the SDK with your Galaxy Store API key and set `store` to `GALAXY`: ```jsx import Purchases from 'react-native-purchases'; import { GALAXY_BILLING_MODE } from 'react-native-purchases-store-galaxy'; Purchases.configure({ apiKey: , store: 'GALAXY', // Optional. Defaults to PRODUCTION. galaxyBillingMode: GALAXY_BILLING_MODE.TEST, }); ``` `galaxyBillingMode` is optional and defaults to `GALAXY_BILLING_MODE.PRODUCTION`. Use `GALAXY_BILLING_MODE.TEST` for test purchases or `GALAXY_BILLING_MODE.ALWAYS_FAIL` to test failure scenarios. Only use production mode when submitting your app for beta or production distribution. **Making test purchases:** Galaxy Store test purchases require a physical Galaxy device signed in with a Samsung account. The Galaxy Store does not support test purchases in emulators. Before testing purchases, make sure you have also [set up your Galaxy Store app](https://www.revenuecat.com/docs/platform-resources/galaxy-platform-resources/galaxy-setup-guide) and [created Galaxy Store products](https://www.revenuecat.com/docs/getting-started/entitlements/galaxy-products). ## React Native Web RevenueCat's React Native SDK supports web platforms, so you can manage subscriptions across React Native web, mobile, and desktop apps using the same SDK. ### Web product configuration To enable web purchases in your React Native app, configure products using a [RevenueCat Billing app](https://www.revenuecat.com/docs/web/overview): 1. Create a RevenueCat Billing app in your RevenueCat project dashboard. 2. Configure your products for web purchases. For detailed instructions, see the [RevenueCat Billing overview](https://www.revenuecat.com/docs/web/overview). :::info[RevenueCat Billing vs In-App Purchases] RevenueCat Billing is RevenueCat's billing engine for web purchases, which uses Stripe as the payment processor. This is separate from iOS/Android in-app purchases but integrates with the same RevenueCat entitlements system, allowing unified subscription management across platforms. ::: ### Current limitations When using the React Native SDK on web, keep in mind the following: - **RevenueCat Billing required**: Web purchases require RevenueCat Billing setup. Native iOS/Android in-app purchases cannot be processed through the web platform. - **Payment processing**: RevenueCat Billing purchases use Stripe as the payment processor. - **Customer Portal**: Users can manage their web subscriptions through the RevenueCat-provided customer portal. - **Platform separation**: Web products must be configured separately from iOS/Android products in the RevenueCat dashboard, though entitlements can be shared across platforms. - **User identity**: For unified cross-platform subscriptions, use the same App User ID across web and mobile platforms. - **Unsupported operations**: `getProducts`, `purchaseProduct`, and `restorePurchases` won't work on web environments. ## Next steps You've installed the RevenueCat SDK and verified your project builds. - [Configure the SDK](https://www.revenuecat.com/docs/getting-started/configuring-sdk) with your project's API key — the next step in the [Quickstart](https://www.revenuecat.com/docs/getting-started/quickstart). - Testing without an App Store or Google Play setup? Purchases work out of the box with the [Test Store](https://www.revenuecat.com/docs/test-and-launch/sandbox/test-store).