# Promoted Iap

Generates Promoted In-App Purchase setup with StoreKit 2 product configuration, paywall...

- Repository: https://github.com/rshankras/claude-code-apple-skills (846 stars)
- Category: Mobile
- License: MIT
- Last updated: 2026-07-24
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add rshankras/claude-code-apple-skills --skill promoted-iap -g -a claude-code -y`
Codex: `npx skills add rshankras/claude-code-apple-skills --skill promoted-iap -g -a codex -y`
Cursor: `npx skills add rshankras/claude-code-apple-skills --skill promoted-iap -g -a cursor -y`
Gemini CLI: `npx skills add rshankras/claude-code-apple-skills --skill promoted-iap -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add rshankras/claude-code-apple-skills`

## Description

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.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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)

The rest: https://github.com/rshankras/claude-code-apple-skills/blob/HEAD/skills/generators/promoted-iap/SKILL.md