revenuecat-migrate

Detect the app platform and guide RevenueCat SDK migration with validation steps.

58|5|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/RevenueCat/ai-toolkit --skill revenuecat-migrate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: revenuecat-migrate
Source: https://github.com/RevenueCat/ai-toolkit/tree/main/revenuecat/skills/revenuecat-migrate
Command: npx skills add https://github.com/RevenueCat/ai-toolkit --skill revenuecat-migrate

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps you migrate an app to RevenueCat or upgrade the RevenueCat SDK safely by identifying your platform, choosing the correct migration path, and preventing transaction double-processing.

Core Features & Use Cases

  • Platform-aware migration planning: Detects React Native, Flutter, Kotlin Multiplatform, Android native, and iOS native by inspecting your project structure and configuration files.
  • Observer-mode adoption for existing IAP: Guides you to adopt RevenueCat while keeping your current StoreKit/Billing purchase flow, including the required “complete/acknowledge” ownership to avoid refunds or inconsistent state.
  • Major-version SDK upgrade workflow: Provides a structured approach for migrating across major versions by directing you to authoritative CHANGELOGs, migration guides, and release notes.

Quick Start

Tell your AI: You are migrating my app to RevenueCat—my platform is iOS (or Android/Flutter/React Native/KMP), I currently use StoreKit/Play Billing directly, and I want an observer-mode setup—read my project files and give me the exact next steps to configure purchasesAreCompletedBy (and the user login continuity step) for a safe cutover.

Frequently Asked Questions about revenuecat-migrate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate to RevenueCat without breaking existing StoreKit or Google Play Billing purchases?

To migrate to RevenueCat safely, keep your existing StoreKit or Google Play Billing code as the transaction owner using observer mode, configuring purchasesAreCompletedBy to prevent double-processing and ensure entitlement continuity.

Can I use RevenueCat observer mode with my Flutter or React Native app?

Yes, observer mode supports Flutter and React Native apps. The migration process detects your platform from project files and guides you to configure RevenueCat alongside your current IAP flow without taking over purchase completion.

What is the best way to upgrade the RevenueCat SDK across major versions?

The best way to upgrade the RevenueCat SDK across major versions is to follow a structured workflow that directs you to authoritative CHANGELOGs, migration guides, and release notes while applying necessary config and API changes.

Why do I need to configure purchasesAreCompletedBy when adopting RevenueCat?

Configuring purchasesAreCompletedBy is required during RevenueCat adoption to designate your existing StoreKit or Google Play Billing code as the transaction owner, preventing double-processing, inconsistent state, and unintended refunds.

How do I validate entitlement continuity after migrating to RevenueCat?

Validate entitlement continuity after migrating to RevenueCat by running sandbox ingestion tests that confirm transaction ingestion and entitlement behavior remain consistent with your previous IAP setup.

Does migrating to RevenueCat with observer mode work for Kotlin Multiplatform projects?

Yes, migrating to RevenueCat with observer mode works for Kotlin Multiplatform projects. The platform-aware migration detects your project structure and applies the correct configuration to preserve your existing purchase flow.