integrating-revenuecat

RevenueCat Integration Reference

Plugin Tools

Extract product IDs and entitlements from your codebase:

# Scan codebase for RevenueCat identifiers
cd /path/to/expo-toolkit && npm run extract-product-ids

# Or specify directory
node tools/extract-product-ids.js /path/to/your/app
node tools/extract-product-ids.js /path/to/your/app --json

This extracts:

• Product IDs (e.g., com.yourapp.premium.monthly)
• Entitlement names (e.g., premium)
• Offering identifiers
• Package types ($rc_monthly, $rc_annual, etc.)

Use the output to cross-reference with RevenueCat Dashboard.

RevenueCat Concepts

Hierarchy

RevenueCat Account
└── Project (your app)
    └── Apps (iOS, Android, etc.)
        └── Products (from App Store Connect / Play Console)
            └── Offerings (groups of products)
                └── Packages (individual purchasable items)
                    └── Entitlements (what the user gets)

Key Terms

Term	Description
Product	An item in App Store Connect or Play Console
Entitlement	A feature/access level users can unlock
Offering	A group of packages to present to users
Package	A specific purchasable item with a product
Customer	A user identified by app user ID

SDK Installation

For Expo (Managed Workflow)

npx expo install react-native-purchases

For Expo (Prebuild/Bare)

npm install react-native-purchases
npx expo prebuild

Plugin Configuration

Add to app.config.js or app.json:

{
  "expo": {
    "plugins": [
      [
        "react-native-purchases",
        {
          "REVENUECAT_API_KEY": "appl_xxxxxxxx", // iOS key
          // Or for Android:
          // "REVENUECAT_API_KEY": "goog_xxxxxxxx"
        }
      ]
    ]
  }
}

Multi-platform setup:

plugins: [
  [
    "react-native-purchases",
    {
      "REVENUECAT_API_KEY_IOS": "appl_xxxxxxxx",
      "REVENUECAT_API_KEY_ANDROID": "goog_xxxxxxxx"
    }
  ]
]