Install the SDK
Install the Superwall React Native SDK via your favorite package manager.
This guide is for Expo projects that want to integrate Superwall using our Expo SDK.
This doesn't sound like you?
- React Native app, new to Superwall → See our installation guide for bare React Native apps
- React Native app with existing Superwall SDK → See our migration guide
Important: Expo SDK 53+ Required
This SDK is exclusively compatible with Expo SDK version 53 and newer. For projects using older Expo versions, please use our legacy React Native SDK.
Expo Go is Not Supported
The Superwall SDK uses native modules that are not available in Expo Go. You must use an Expo Development Build to run your app with Superwall.
To create a development build:
npx expo run:ios
# or
npx expo run:androidIf you see the error Cannot find native module 'SuperwallExpo', see our Debugging guide for solutions.
To see the latest release, check out the Superwall Expo SDK repo.
bunx expo install expo-superwallpnpm dlx expo install expo-superwallnpx expo install expo-superwallyarn dlx expo install expo-superwallVersion Targeting
Superwall requires iOS 15.1 or higher and Android SDK 23 or higher. Your iOS deployment target must also meet the minimum required by your installed Expo SDK. For Expo SDK 56 and newer, use iOS 16.4 or higher.
Expo SDK v1.5.0 upgrades Google Play Billing to 9.1.0. If your app or another SDK uses Google Play Billing directly, review Google's Billing Library 9 migration guide and test your purchase flows before upgrading.
First, install the expo-build-properties config plugin if your Expo project hasn’t yet:
npx expo install expo-build-propertiesThen, add the following to your app.json or app.config.js file:
{
"expo": {
"plugins": [
...
[
"expo-build-properties",
{
"android": {
"minSdkVersion": 23
},
"ios": {
"deploymentTarget": "15.1" // Use 16.4 or higher for Expo SDK 56+
}
}
]
]
}
}How is this guide?