Promoted In-App Purchases Generator

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.

When This Skill Activates

Use this skill when the user:

• Asks to "promote IAP" or "show purchase on product page"
• Mentions "promoted in-app purchase" or "App Store product page IAP"
• Wants subscription/IAP visible in App Store search results
• Asks about paymentQueue(_:shouldAddStorePayment:for:)
• Wants to handle purchases initiated from the App Store

Pre-Generation Checks

1. Project Context Detection

• Check for existing StoreKit implementation
• Check deployment target (iOS 15+ for StoreKit 2)
• Look for existing IAP product definitions
• Check if paywall-generator was already used

2. Conflict Detection

Glob: **/*Promoted*.swift, **/*StorePayment*.swift
Grep: "shouldAddStorePayment" or "PurchaseIntent" or "promotedPurchase"

How Promoted IAP Works

1. App Store Connect: Mark IAP products as "Promoted" with promotional image
2. Product Page: Up to 20 promoted IAPs appear on your product page
3. Search Results: Promoted IAPs can appear in search
4. User Action: User taps "Buy" on App Store → your app opens to complete purchase
5. Your App: Must handle the incoming purchase intent

Promoted IAP Display Order

• You control the order in App Store Connect
• Choose your most compelling IAP as the first promoted product
• Apple may also feature your IAPs in editorial content

Configuration Questions

Ask user via AskUserQuestion:

1. What type of IAP to promote?

   • Auto-renewable subscription
   • Non-consumable (one-time unlock)
   • Consumable (credits/tokens)

2. How to handle App Store-initiated purchases?

   • Show immediately (direct purchase)
   • Show paywall first (let user see options before buying)
   • Show onboarding then purchase (new users from App Store)