React Native - Package.json (Legacy)
Install the Superwall React Native SDK via npm or yarn. To see the latest release, [check out the repository](https://github.com/superwall/react-native-superwall).
Note that Superwall does not refetch its configuration during hot reloads. So, if you add products, edit a paywall, or otherwise change anything with Superwall, re-run your app to see those changes.
Option 1: React-Native package
To use Superwall in your React Native project, add @superwall/react-native-superwall
as a dependency in your package.json
file by using npm or yarn:
Option 2: Using Expo
If you have an Expo project, you can add the dependency with npx:
Please note that Superwall does not support Expo Go. Expo Go only supports prebuilt Expo libraries; it cannot load third-party SDKs with custom native code. If you are using a managed workflow, create a development build to continue using Expo tools while including Superwall. Otherwise, you will encounter linking errors.
Here's a quick table to review your installation methods:
Workflow | Superwall Support | Notes |
---|---|---|
Expo Go | ❌ Not supported | Expo Go cannot load native SDKs. |
Managed Workflow | ℹ️ Requires additional step | Use a Development Build. |
Development Build | ✅ Supported | Works with Expo tools + custom code. |
Unmanaged (Bare) | ✅ Supported | Full control over native code. |
iOS Deployment Target
Superwall requires iOS 14.0 or higher. Ensure your React Native project's iOS deployment target is 14.0 or higher by updating ios/Podfile.
Android Configuration
For Android projects, you'll also need to include Superwall's Maven repository.
First, install the expo-build-properties
config plugin if your Expo project hasn’t yet:
Then, add the following to your app.json
or app.config.js
file: