​
Prerequisites

Before setting up Superwall, ensure you have:
  • Your app’s bundle identifier from app.json
  • Your app’s package name from app.json
  • Access to your project’s .env file
Complete this setup guide first before moving on to the platform-specific configuration steps.

​
Create Superwall account

  1. Create an account at Superwall
  2. Create a new project with these details:
    • Platform: React Native
    • Project Name: Your project name (use your app name)
    • App Name: Your app name
    • iOS Bundle ID: Your app’s bundle identifier from app.json
    • Android Bundle ID: Your app’s package name from app.json
  3. Click Create App
Superwall will create a new project with apps for both iOS and Android, and take you to the dashboard page.

​
Enable Superwall in your app

1

Find your API keys

For React Native, you need separate API keys for iOS and Android.
  1. In the Superwall dashboard, go to Settings > Keys
  2. Use the platform icons in the top left to switch between your iOS and Android apps
  3. Copy the Public API Key (starts with pk_) for each platform
You need different API keys for iOS and Android. Make sure to save both keys securely.
2

Add API keys to environment variables

  1. Open your project’s .env file
  2. Add the following lines with your API keys:
.env
EXPO_PUBLIC_SUPERWALL_API_KEY_IOS=pk_...
EXPO_PUBLIC_SUPERWALL_API_KEY_ANDROID=pk_...
Never commit API keys to version control. The .env file should be in your .gitignore.
3

Implement Superwall SDK

Important: The detailed implementation steps are in the integrations/superwall/README.md file in your boilerplate codebase. You must follow these instructions carefully to properly activate Superwall.
The README.md contains specific guidance for:
  • Which packages to install and their versions
  • Configuration specific to your boilerplate
  • How to set up the Superwall provider
Make sure to complete all the steps in the README.md file before proceeding to platform-specific configuration.
4

Verify basic setup

  1. Confirm the required dependencies are installed
  2. Ensure the Superwall provider is properly set up in your application
  3. Verify that your environment variables are being correctly accessed in the code
Your Superwall integration is ready when you can access the provider in your app and environment variables are loaded correctly.

​
Next steps

After setting up Superwall in your codebase, continue with the platform-specific guides:
Make sure to complete the Superwall SDK implementation in the README.md file before proceeding to platform-specific configuration. This ensures your integration is properly set up before adding platform-specific features.