How to Add Subscriptions to Mobile Apps Using RevenueCat (Flutter, iOS & Android Guide 2026)

# Add both packages for SDK + paywall UI
dependencies:
  purchases_flutter: ^8.10.5
  purchases_ui_flutter: ^8.10.5

// Android: subclass FlutterFragmentActivity for paywall support
import io.flutter.embedding.android.FlutterFragmentActivity

class MainActivity: FlutterFragmentActivity()

<!-- Add BILLING permission for Google Play -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="com.android.vending.BILLING" />

import 'package:purchases_flutter/purchases_flutter.dart';
import 'dart:io';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await _initRevenueCat();
  runApp(MyApp());
}

Future<void> _initRevenueCat() async {
  // Enable debug logs in development only
  await Purchases.setLogLevel(LogLevel.debug);

  PurchasesConfiguration config;
  if (Platform.isIOS) {
    config = PurchasesConfiguration('appl_YOUR_IOS_KEY');
  } else {
    config = PurchasesConfiguration('goog_YOUR_ANDROID_KEY');
  }
  await Purchases.configure(config);
}

import 'package:purchases_ui_flutter/purchases_ui_flutter.dart';

// Present the RevenueCat paywall — design configured in dashboard
await RevenueCatUI.presentPaywallIfNeeded(
  "premium", // your entitlement ID
);

// Or embed inline as a widget
PaywallView(
  offeringIdentifier: "default",
  onPurchaseCompleted: (customerInfo, storeTransaction) {
    // User subscribed — unlock premium features
    Navigator.pop(context);
  },
  onPurchaseCancelled: () {
    // User closed without buying — handle gracefully
  },
  onRestoreCompleted: (customerInfo) {
    // User restored a prior purchase
  },
);

// Fetch offerings — build your own UI around them
final offerings = await Purchases.getOfferings();
final current = offerings.current;

if (current != null) {
  final monthly = current.monthly; // Package?
  final annual = current.annual;

  // Purchase a specific package
  if (monthly != null) {
    final customerInfo = await Purchases.purchasePackage(monthly);
    final isPremium =
      customerInfo.entitlements.active.containsKey("premium");
    if (isPremium) { // ✅ Unlock features }
  }
}

// Check subscription status anywhere in your app
Future<bool> isPremium() async {
  try {
    final customerInfo = await Purchases.getCustomerInfo();
    return customerInfo.entitlements.active.containsKey("premium");
  } catch (_) {
    return false; // fail gracefully — don't block the app
  }
}

// Listen to subscription changes in real-time (e.g. during live streaming)
Purchases.addCustomerInfoUpdateListener((customerInfo) {
  final isPremium =
    customerInfo.entitlements.active.containsKey("premium");
  // Update UI state based on new subscription status
});

// Restore purchases (required by App Store guidelines)
TextButton(
  onPressed: () async {
    await Purchases.restorePurchases();
  },
  child: Text("Restore Purchases"),
);