swiftship/internal/skills/data/features/revenuecat/SKILL.md
RevenueCat SDK patterns for in-app purchases, subscriptions, and entitlements. Use when implementing monetization features with RevenueCat.
npx skillsauth add abdullah4ai/apple-dev-docs revenuecatInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Configure RevenueCat in your App's init() with StoreKit 2:
import RevenueCat
@main
struct MyApp: App {
init() {
#if DEBUG
Purchases.logLevel = .debug
#endif
Purchases.configure(
with: Configuration.Builder(withAPIKey: AppConfig.revenueCatAPIKey)
.with(storeKitVersion: .storeKit2)
.build()
)
}
}
The API key comes from AppConfig.revenueCatAPIKey — NEVER hardcode it inline.
let offerings = try await Purchases.shared.offerings()
if let current = offerings.current {
for package in current.availablePackages {
let product = package.storeProduct
let price = product.localizedPriceString // "$9.99" — dynamic from store
let name = product.localizedTitle // "Premium Monthly"
}
}
let result = try await Purchases.shared.purchase(package: package)
if !result.userCancelled {
let isPremium = result.customerInfo.entitlements[AppConfig.entitlementID]?.isActive == true
}
Handle errors:
.purchaseCancelledError — user tapped Cancel, do nothing.paymentPendingError — payment pending approval (Ask to Buy).storeProblemError — App Store issue, show retry.purchaseNotAllowedError — device restrictionsALWAYS use AppConfig.entitlementID — never hardcode the entitlement string:
let customerInfo = try await Purchases.shared.customerInfo()
let isPremium = customerInfo.entitlements[AppConfig.entitlementID]?.isActive == true
for try await customerInfo in Purchases.shared.customerInfoStream {
let isPremium = customerInfo.entitlements[AppConfig.entitlementID]?.isActive == true
}
let customerInfo = try await Purchases.shared.restorePurchases()
When using authentication (Supabase, Firebase, etc.), link the user ID:
let (customerInfo, _) = try await Purchases.shared.logIn(userId)
Call logIn after the user authenticates. Call logOut on sign-out:
let customerInfo = try await Purchases.shared.logOut()
AppConfig.revenueCatAPIKeyAppConfig.entitlementIDAppConfig.ProductID constantspackage.storeProduct.localizedPriceString — NEVER hardcode dollar amountsSee SDK Setup, Purchase Flow, and Entitlements for detailed patterns.
tools
Apple platform skill for docs, WWDC lookup, App Store Connect work, and SwiftUI app generation. Use repo-local `node cli.js` for Apple docs and WWDC search, `appledev store` for App Store Connect workflows, and `appledev build` for app scaffolding or fix loops on macOS. USE WHEN: Apple APIs, WWDC sessions, TestFlight/App Store tasks, or building/fixing Apple-platform apps. DON'T USE WHEN: non-Apple platforms, generic backend work, or general web research. EDGE CASES: docs-only queries use `node cli.js` in this repo, not `appledev`; release workflows use `appledev store`; app scaffolding uses `appledev build`; rules-only requests can read `references/ios-rules/` or `references/swiftui-guides/` progressively without invoking binaries.
tools
All-in-one Apple developer skill with three integrated tools shipped as a single unified binary. (1) Documentation search across Apple frameworks, symbols, and 1,267 WWDC sessions from 2014-2025. No credentials needed. (2) App Store Connect CLI with 120+ commands covering builds (find/wait/upload), TestFlight, pre-submission validate, submissions, signing, subscriptions (family-sharable), IAP, analytics, Xcode Cloud, metadata workflows, release pipeline dashboard, insights, win-back offers, promoted purchases, product pages, nominations, accessibility declarations, pre-orders, pricing filters, localizations update, diff, webhooks with local receiver, workflow automation, and more. Requires App Store Connect API key. (3) Multi-platform app builder (iOS/watchOS/tvOS/iPad/macOS/visionOS) that generates complete Swift/SwiftUI apps from natural language with auto-fix, simulator launch, interactive chat mode, and open-in-Xcode. Requires an LLM API key and Xcode. Includes 38 iOS development rules and 12 SwiftUI best practice guides for Liquid Glass, navigation, state management, and modern APIs. All three tools ship as one binary (appledev). USE WHEN: Apple API docs, App Store Connect management, WWDC lookup, or building iOS/watchOS/tvOS/macOS/visionOS apps from scratch. DON'T USE WHEN: non-Apple platforms or general coding.
testing
watchOS complications: WidgetKit complication families, accessory sizes, timeline providers for watch face. Use when implementing watchOS-specific patterns related to widgets.
development
watchOS haptic feedback: WKInterfaceDevice preset haptic types for wrist-based feedback. Use when implementing watchOS-specific patterns related to haptics.