integrating-revenuecat
Installation
SKILL.md
RevenueCat (Flutter) Latest Version Best Practices Guide (v10.x)
Goal
RevenueCat is the industry-standard solution for handling In-App Purchases (IAP) and subscriptions in mobile applications. In Flutter, the official package is purchases_flutter (paired with purchases_ui_flutter for pre-built paywall UI).
Instructions
1. Core Concept: Entitlements > Products
In traditional IAP development, developers often focus on "which Product ID the user purchased." RevenueCat's best practice is: Always check the user's Entitlements.
- Products: The actual items configured in Apple/Google consoles (e.g.,
monthly_sub_199). - Offerings: RevenueCat packages multiple Products into a display offering (e.g., a default offering contains "Monthly" and "Annual" subscriptions). This makes A/B testing extremely easy, allowing you to swap products without changing the APP code.
- Entitlements: The ultimate goal unlocked after a user purchases (e.g.,
pro_access).
👉 Your APP logic should ALWAYS only check if pro_access is active. Do not care about which offering the user bought to get it.