RevenueCat App Setup

Step-by-step guide for setting up an iOS or Android app in RevenueCat.

Description

Walks you through the complete app setup process including:

• Creating the app in RevenueCat
• Configuring store credentials (App Store Connect or Google Play Console)
• Setting up products
• Getting your API key

Usage

/rc:create-app <platform> [app_identifier] [project_name]

Arguments:

• platform (required): Either ios or android
• app_identifier (optional): Bundle ID (iOS) or package name (Android)
• project_name (optional): Name of the project to create the app in. If not provided, the user will be prompted to select a project.

Available as $ARGUMENTS.

Instructions

When the user invokes this skill, guide them through app setup:

1. Parse Arguments (from $ARGUMENTS)

   • Extract platform (required) - must be ios or android
   • Extract app_identifier (optional) - bundle ID or package name
   • Extract project_name (optional)
   • Arguments can be in any order, but platform keywords (ios, android) are detected first
   • Project name matching is case-insensitive and supports partial matches
   • If platform is not provided, ask the user to specify it

2. Get Projects

   • Call mcp_RC_get_project to retrieve all accessible projects
   • If project_name is specified in arguments, filter projects by name (case-insensitive partial match)
   • If no matching project found, inform the user and list available projects
   • If no project_name provided, prompt the user to select a project
   • Once project is selected, call mcp_RC_list_apps to check if an app for this platform already exists

3. Create App (if needed) Ask for (if not in $ARGUMENTS):

   • iOS: Bundle ID from Xcode (e.g., com.company.appname)
   • Android: Package name/applicationId from build.gradle (e.g., com.company.appname)

   Then call mcp_RC_create_app with:

   • iOS: type: "app_store", bundle_id: provided value
   • Android: type: "play_store", package_name: provided value
   • name: derived from identifier or ask user

4. Get API Key

   • Call mcp_RC_list_public_api_keys with the new app ID
   • Provide the key with appropriate code snippet (Swift for iOS, Kotlin for Android)

5. Guide Through Store Setup

   For iOS (App Store Connect):

   a) In-App Purchase Key (Recommended for StoreKit 2)

   • App Store Connect → Users and Access → Integrations → In-App Purchase
   • Generate key, download .p8 file
   • Note the Key ID and Issuer ID

   b) Shared Secret (Legacy StoreKit 1)

   • App Store Connect → App → App Information → App-Specific Shared Secret

   For Android (Google Play Console):

   a) Service Account Credentials

   • Create a service account in Google Cloud Console
   • Grant "Service Account User" role
   • Create JSON key
   • In Play Console, grant the service account access with "View financial data" permission

   b) Real-time Developer Notifications (RTDN)

   • Set up Cloud Pub/Sub topic
   • Configure in Play Console → Monetization setup

6. Provide SDK Integration Code Share the appropriate code for the platform.

Example Interactions

Example 1: iOS with project name

User: /rc:create-app ios com.awesomeapp.fitness "Fitness Tracker"

Assistant: I'll help you set up your iOS app in the Fitness Tracker project.

Step 1: Creating App

Creating iOS app with bundle ID: com.awesomeapp.fitness

App created successfully!

• App ID: app1a2b3c4d5
• Name: Fitness App
• Platform: App Store

Step 2: Your API Key

import RevenueCat

func application(_ application: UIApplication,
                 didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {

    Purchases.logLevel = .debug  // Remove in production
    Purchases.configure(withAPIKey: "appl_aBcDeFgHiJkLmNoPqRsT")

    return true
}

Step 3: App Store Connect Configuration

You'll need to configure credentials in the RevenueCat dashboard. Here's what to get from App Store Connect:

Option A: In-App Purchase Key (Recommended for StoreKit 2)

1. Go to App Store Connect → Users and Access → Integrations
2. Click "In-App Purchase" → Generate In-App Purchase Key
3. Download the .p8 file and note the Key ID
4. Copy the Issuer ID from the top of the page
5. Enter these in RevenueCat Dashboard → App Settings

Option B: Shared Secret (Legacy StoreKit 1)

1. Go to App Store Connect → Your App → App Information
2. Scroll to "App-Specific Shared Secret" → Manage
3. Generate or copy the secret
4. Enter in RevenueCat Dashboard → App Settings

Step 4: Create Products

Would you like me to help you create products? Use /rc:create-product to add subscriptions or one-time purchases.

Example 2: Android with project name

User: /rc:create-app android com.awesomeapp.fitness "Music Player"

Assistant: I'll help you set up your Android app in the Music Player project.

Step 1: Creating App

Creating Android app with package name: com.awesomeapp.fitness

App created successfully!

• App ID: app1a2b3c4d5
• Name: Fitness App
• Platform: Play Store

Step 2: Your API Key

// Application.kt
import com.revenuecat.purchases.Purchases
import com.revenuecat.purchases.PurchasesConfiguration

class MainApplication : Application() {
    override fun onCreate() {
        super.onCreate()

        Purchases.logLevel = LogLevel.DEBUG  // Remove in production
        Purchases.configure(
            PurchasesConfiguration.Builder(this, "goog_aBcDeFgHiJkLmNoPqRsT").build()
        )
    }
}

Step 3: Google Play Console Configuration

You'll need to set up service account credentials:

Creating a Service Account:

1. Go to Google Cloud Console
2. Create a new project or select existing
3. Go to IAM & Admin → Service Accounts
4. Create Service Account with name like "revenuecat-integration"
5. Skip the optional steps, click Done
6. Click on the service account → Keys → Add Key → JSON
7. Download and save the JSON file securely

Granting Play Console Access:

1. Go to Google Play Console
2. Go to Users and Permissions → Invite new users
3. Enter the service account email (ends with @...iam.gserviceaccount.com)
4. Grant these permissions:
   • View financial data, orders, and cancellation survey responses
   • Manage orders and subscriptions
5. Add your app to the service account's access

Upload to RevenueCat: Upload the JSON file in RevenueCat Dashboard → App Settings → Service Credentials

Step 4: Create Products

Would you like me to help you create products? Use /rc:create-product to add subscriptions or one-time purchases.

Note: For Play Store, subscription products use the format product_id:base_plan_id

Example 3: Without platform

User: /rc:create-app

Assistant: I'll help you set up an app. Which platform are you setting up?

• ios - App Store (iPhone, iPad, Mac)
• android - Google Play Store

Example 4: Without project name

User: /rc:create-app ios

Assistant: I'll help you set up an iOS app. First, which project should this app belong to?

Available projects:

• Fitness Tracker
• Recipe App
• Photo Editor
• Music Player
• Task Manager

iOS Checklist

After setting up an iOS app, make sure you have:

• Added the RevenueCat SDK to your Xcode project
• Configured your API key in your app
• Set up App Store Connect credentials in RevenueCat dashboard
• Created products in App Store Connect
• Created matching products in RevenueCat
• Created entitlements and offerings
• Tested with sandbox account

Swift Package Manager

Add RevenueCat to your project:

https://github.com/RevenueCat/purchases-ios.git

Or with CocoaPods:

pod 'RevenueCat'

Android Checklist

After setting up an Android app, make sure you have:

• Added the RevenueCat SDK to your app/build.gradle
• Configured your API key in Application class
• Created service account and uploaded credentials
• Created products in Play Console (with base plans for subscriptions)
• Created matching products in RevenueCat
• Created entitlements and offerings
• Set up Real-time Developer Notifications (optional but recommended)
• Tested with a license tester account

Gradle Setup

Add to your app/build.gradle:

dependencies {
    implementation 'com.revenuecat.purchases:purchases:7.+'
}

Or with Kotlin DSL:

dependencies {
    implementation("com.revenuecat.purchases:purchases:7.+")
}

Product ID Format (Play Store)

For Play Store Billing Library 5+:

• Subscriptions: product_id:base_plan_id (e.g., premium:monthly)
• One-time purchases: Just the SKU (e.g., lifetime_access)

Notes

iOS

• Use a sandbox Apple ID for testing (Settings → App Store → Sandbox Account)
• Enable StoreKit Testing in Xcode for local development
• The API key shown is the PUBLIC key - safe to include in your app

Android

• Add license testers in Play Console → Setup → License testing
• Service account changes can take up to 24 hours to propagate
• The API key shown is the PUBLIC key - safe to include in your app
• For older apps still on Billing Library 4, use just the product ID for subscriptions