Purpl Documentation

Get started

Install Purpl Swift and register the purchase configuration for the app.

Requirements

Swift 6.2 or later
iOS 26 or later, or macOS 26 or later
StoreKit 2 products registered in App Store Connect

Install the package

Add the Purpl-Swift repository in Xcode Package Dependencies. Link Purpl for purchases and entitlements, and add PurplUI when you also want the default SwiftUI paywall.

Package URL

https://github.com/ineedtoint/Purpl-Swift.git

Register purchase configuration

Define every product used by the app and the entitlements granted by each product, then configure Purpl once at launch.

Swift

import Purpl

let plusEntitlement = PurchaseEntitlement(identifier: "plus")

let monthlyProduct = PurchaseProduct(
    productIdentifier: "time.plus.monthly",
    entitlementIdentifier: plusEntitlement.identifier
)
let yearlyProduct = PurchaseProduct(
    productIdentifier: "time.plus.yearly",
    entitlementIdentifier: plusEntitlement.identifier
)

let purchaseConfiguration = PurchaseConfiguration(
    entitlements: [plusEntitlement],
    products: [monthlyProduct, yearlyProduct]
)

Purchases.configure(purchaseConfiguration)