integrating-superwall-expo
Installation
SKILL.md
Integrating Superwall in React Native Expo (expo-superwall)
Why this skill exists
Superwall’s Expo SDK (expo-superwall) is native-module based, so Expo Go won’t work and setup mistakes often look like “Cannot find native module 'SuperwallExpo'”. This skill provides a reliable, repeatable workflow to:
- install + configure
expo-superwallcorrectly in Expo SDK 53+ - present paywalls via placements (remote campaigns) and implement feature gating
- manage users + attributes, and keep subscription status in sync (including RevenueCat)
- wire deep links / web checkout, and troubleshoot the common integration failures
Non‑negotiables (check first)
- Expo SDK 53+ is required for
expo-superwall. - Expo Go is not supported. Use an Expo Development Build (
npx expo run:ios|androidor EAS dev client). - Target minimum OS versions:
- iOS deployment target: 15.1+
- Android minSdkVersion: 21+
- Superwall config does not refetch during hot reload. After dashboard changes (paywalls/products/campaigns), fully restart the app.