Generates Promoted In-App Purchase setup with StoreKit 2 product configuration, paywall integration, and App Store product page display. Use when setting up promoted purchases that appear on the App Store product page.
Set up promoted In-App Purchases so your premium offerings appear directly on your App Store product page, in search results, and in editorial features.
Use this skill when the user:
paymentQueue(_:shouldAddStorePayment:for:)paywall-generator was already usedGlob: **/*Promoted*.swift, **/*StorePayment*.swift
Grep: "shouldAddStorePayment" or "PurchaseIntent" or "promotedPurchase"
Ask user via AskUserQuestion:
What type of IAP to promote?
How to handle App Store-initiated purchases?
Number of promoted products?
Read templates.md for promoted IAP implementation code.
- If Sources/Store/ exists → Sources/Store/Promoted/
- If Store/ exists → Store/Promoted/
- Otherwise → Store/Promoted/
Store/Promoted/
├── PromotedPurchaseHandler.swift # App Store purchase handling
├── PromotedProductConfiguration.swift # Product setup & image specs
└── PromotedPurchaseFlowView.swift # In-app purchase completion UI
Handle App Store-Initiated Purchases (StoreKit 2):
@main
struct MyApp: App {
var body: some Scene {
WindowGroup {
ContentView()
.task {
// Listen for purchases initiated from App Store
for await purchaseIntent in PurchaseIntent.intents {
await PromotedPurchaseHandler.shared.handle(purchaseIntent)
}
}
}
}
}
Complete the Purchase:
// PromotedPurchaseHandler determines the right flow:
// 1. Direct purchase (existing user, known product)
// 2. Paywall (show options first)
// 3. Onboarding (new user from App Store)
generators/paywall-generator — Full paywall for purchase completiongenerators/subscription-offers — Offer types for promoted subscriptionsapp-store/marketing-strategy — Strategic product promotion planning