paywall-generator

Paywall Generator

Generate a complete StoreKit 2 subscription paywall with modern SwiftUI views, subscription status tracking, and proper purchase handling.

When This Skill Activates

Use this skill when the user:

• Asks to "add subscriptions" or "add paywall"
• Mentions "in-app purchases" or "IAP"
• Wants "StoreKit 2" implementation
• Asks about "subscription management"
• Mentions "premium features" or "pro version"

Paywall Design Principles (Apple's Data)

• Keep sign-up to 3-4 taps. Per Apple's Tech Talk: 61% conversion at 3 taps, 48% at 4 — collapsing to 7% at 9 taps.
• Make the paywall glanceable — value proposition, price, and renewal/trial terms in one view, no scrolling to find the price.
• Show clear renewal and trial terms everywhere you pitch the subscription, not just on the paywall.
• Persistent entry point over pop-ups — a tasteful, always-available subscribe button (plus subscribe/manage in Settings). Pop-ups train users to dismiss.
• Trigger the offer at moments of interest — when the user taps locked content, not on a timer.
• Offer 3-4 duration tiers so users self-select their commitment level.
• Let users experience value first — free trial (works best for known brands), freemium, or content sampling (e.g., N free articles per month).

Pre-Generation Checks

1. Project Context Detection

• Check for existing StoreKit implementations
• Check deployment target (StoreKit 2 requires iOS 15+)
• Look for existing product IDs in codebase
• Identify source file locations

2. Conflict Detection

Search for existing StoreKit:

Glob: **/*Store*.swift, **/*Purchase*.swift, **/*Subscription*.swift
Grep: "import StoreKit" or "Product.products"

If found, ask user:

• Replace existing implementation?
• Extend with additional features?

Apple Docs Reference

StoreKit subscription APIs (iOS 18.4+):

• SubscriptionOfferView - New SwiftUI view for merchandising subscriptions
• subscriptionStatusTask modifier for tracking subscription state
• Transaction.currentEntitlements(for:) - New API for entitlements
• RenewalInfo enhancements for expiration reasons

Configuration Questions

Ask user via AskUserQuestion:

1. Subscription tiers? (multi-select)

   • Monthly
   • Yearly (with discount)
   • Lifetime
   • Weekly

2. Features needed?

   • Free trial
   • Family sharing
   • Promotional offers

3. UI style?

   • Full paywall screen
   • Inline subscription view
   • Both

Generation Process

Step 1: Create Core Files

Generate these files:

1. StoreKitManager.swift - Product loading and purchasing
2. SubscriptionStatus.swift - Status tracking
3. PaywallView.swift - Full paywall UI
4. SubscriptionButton.swift - Individual plan button

Step 2: Create Configuration

• Products.swift - Product ID constants

Step 3: Determine File Location

Check project structure:

• If Sources/ exists → Sources/Store/
• If App/ exists → App/Store/
• Otherwise → Store/

Product ID Setup

App Store Connect

1. Go to App Store Connect > Your App > Subscriptions
2. Create subscription group
3. Add subscription products with IDs like:
   • com.yourapp.subscription.monthly
   • com.yourapp.subscription.yearly
   • com.yourapp.subscription.lifetime

StoreKit Configuration (Testing)

Create Products.storekit for local testing:

1. File > New > File > StoreKit Configuration
2. Add products matching your IDs
3. Edit scheme > Options > StoreKit Configuration

Output Format

After generation, provide:

Files Created

Sources/Store/
├── StoreKitManager.swift        # Product loading & purchasing
├── SubscriptionStatus.swift     # Status enum & tracking
├── Products.swift               # Product ID constants
└── Views/
    ├── PaywallView.swift        # Full paywall screen
    ├── SubscriptionButton.swift # Plan selection button
    └── SubscriptionOfferCard.swift # iOS 18.4+ view

Integration Steps

App Entry Point:

@main
struct MyApp: App {
    @State private var subscriptionStatus: SubscriptionStatus = .unknown

    var body: some Scene {
        WindowGroup {
            ContentView()
                .environment(\.subscriptionStatus, subscriptionStatus)
                .subscriptionStatusTask(for: "your.group.id") { statuses in
                    subscriptionStatus = SubscriptionStatus.from(statuses)
                }
        }
    }
}

Show Paywall:

struct ContentView: View {
    @State private var showPaywall = false
    @Environment(\.subscriptionStatus) var status

    var body: some View {
        VStack {
            if status != .subscribed {
                Button("Upgrade to Pro") {
                    showPaywall = true
                }
            }
        }
        .sheet(isPresented: $showPaywall) {
            PaywallView()
        }
    }
}

SubscriptionOfferView (iOS 18.4+):

// Simple merchandising view
SubscriptionOfferView(productID: "com.app.subscription.monthly")
    .prefersPromotionalIcon(true)
    .subscriptionOfferViewDetailAction {
        showPaywall = true
    }

Testing Instructions

1. Create StoreKit Configuration:

   • File > New > StoreKit Configuration
   • Add your products

2. Edit Scheme:

   • Product > Scheme > Edit Scheme
   • Options > StoreKit Configuration > Select your file

3. Test Purchases:

   • Run in Simulator
   • Use Transaction Manager (Debug > StoreKit > Transaction Manager)

4. Test Scenarios:

   • Purchase flow
   • Restore purchases
   • Subscription expiration
   • Renewal

References

• storekit-patterns.md - Best practices and patterns
• templates/ - All template files
• Apple Docs: StoreKit Updates (iOS 18.4+)