StoreKit 2

In-app purchases and subscriptions on Apple platforms, StoreKit 2 (async/await). The deep API reference — setup, every product type, the full purchase/subscription lifecycle, StoreKit views, App Store Server, testing — lives in references/guide.md. This file is the decision and discipline layer: read it first, open the guide for specifics.

Dials

Set these explicitly at the start; they change what "correct" means.

1. RECEIPT_VALIDATION — on-device (default; VerificationResult is signed by Apple and enough for most apps) · server (App Store Server API + signed JWSTransaction when revenue risk is high or you grant server-side).
2. SUBSCRIPTION_MODE — none · single (one auto-renewable) · groups (multiple tiers with upgrade/downgrade + Product.SubscriptionInfo.Status).
3. UI — storekit-views (iOS 17+ StoreView/SubscriptionStoreView, default) · custom (your own merchandising).

When to use

Building or reviewing any purchase, paywall, subscription, restore, or entitlement-gating code that talks to StoreKit directly. If the app uses RevenueCat as the purchase layer, use revenuecat — don't mix two sources of truth for entitlements.

Core rules