What is RevenueCat?

RevenueCat is a secure, reliable, and free to use in-app purchase server with cross-platform support. With the RevenueCat SDK, you can build and manage your app business on any platform without having to maintain purchase infrastructure. You can read more about how RevenueCat fits into your app or you can sign up free to start building.

Installation

Purchases for React Native can be installed either via npm or yarn.
We recommend using the latest version of React Native, or making sure that the version is at least greater than 0.64.

Option 1: Using auto-linking

Recent versions of React Native will automatically link the SDK, so all that's needed is to install the library.

npm install --save react-native-purchases

yarn add react-native-purchases

Option 2: Manual linking

npm install --save react-native-purchases

yarn add react-native-purchases

After that, you should link the library to the native projects by doing:

react-native link react-native-purchases

Additional iOS Setup

Swift Support

If your project has no Swift files or Swift support is disabled for the project, you will need to enable Swift support. The easiest way to do it is to add a single, empty Swift file.

Important: Make sure that the deployment target for iOS is set to at least 11.0 as defined here, both in the project and in the Podfile if you're using Cocoapods.

Option 1. Installing with Cocoapods / ExpoKit (with Auto-linking)

If you've installed the library using Auto-linking, then all you need to do is to run pod install from your iOS folder.

That's it! You can skip ahead to importing the framework

Option 2. Installing with Cocoapods / ExpoKit (Manual linking only)

If your project already uses Cocoapods to install iOS dependencies, common in ExpoKit projects, linking the library should have added it to the podfile. If it hasn't, add the following to your project's podfile to reference the library from your node_modules folder:

pod 'RNPurchases', :path => '../node_modules/react-native-purchases', :inhibit_warnings => true, :modular_headers => false

In your iOS folder, run pod install. If you've just upgraded ExpoKit, you might need to upgrade cocoapods to the newest version: sudo gem install cocoapods.

That's it! You can skip ahead to importing the framework

Option 3. Manually adding the framework (if you're not using Cocoapods)

If you are not using Cocoapods to manage dependencies, Purchases.framework also needs to be added to your iOS project. The npm install will download the correct framework version and the link command will add libRNPurchases.a to the Linked Frameworks and Libraries of your app target in the iOS project.

📘

If you choose to install the framework via CocoaPods, you can skip ahead to importing the framework

Create a Framework Reference in your project

1. Drag Purchases.framework and PurchasesHybridCommon.framework from the RNPurchasessub-project under the libraries section to the outer project and create a reference.

Add iOS Framework to Embedded Binaries

1. In Xcode, in project manager, select your app target.
2. Select the general tab
3. Drag Purchases.framework and PurchasesHybridCommon.framework from your project to the Embedded Binaries section

Add $(PROJECT_DIR)/../node_modules/react-native-purchases/ios to Framework Search paths in build settings

Add Strip Frameworks Phase

The App Store, in it's infinite wisdom, still rejects fat frameworks, so we need to strip our framework before it is deployed. To do this, add the following script phase to your build.

1. In Xcode, in project manager, select your app target.
2. Open the Build Phases tab
3. Add a new Run Script, name it Strip Frameworks
4. Add the following command "${PROJECT_DIR}/../node_modules/react-native-purchases/ios/strip-frameworks.sh" (quotes included)

Link static library

The react-native link command should have added the libRNPurchases.a library to the Linked Frameworks and Libraries section of your app target. If it hasn't add it like this:

Import Purchases

You should now be able to import Purchases

import Purchases from 'react-native-purchases';

📘

Include BILLING permission for Android projects

Don't forget to include the BILLING permission in your AndroidManifest.xml file

<uses-permission android:name="com.android.vending.BILLING" />

📘

Enable In-App Purchase for your iOS project

Don't forget to enable the In-App Purchase capability for your project under Project Target -> Capabilities -> In-App Purchase

ExpoKit special instructions

ExpoKit projects of version 33 or higher can successfully use react-native-purchases. If you haven't upgraded, you can follow the instructions here to upgrade.

react-native-purchases currently doesn't work in the managed workflow for Expo, due to some limitations on Expo's side:

• https://docs.expo.io/introduction/why-not-expo/
• https://expo.canny.io/feature-requests/p/in-app-purchases

If you want to do in-app purchases in your Expo app, you'll have to use the bare workflow.

If you're planning on ejecting from Expo, upgrade your expo version first, THEN eject. It'll save you a whole lot of hassle.

📘

The latest version of react-native-purchases compatible with expo-in-app-purchases in observer mode is 3.3.2, since Expo hasn't upgraded to BillingClient version 3 yet (GitHub issue for reference).

Next Steps

• Now that you've installed the Purchases SDK in your React Native app, get started by initializing an instance of Purchases