promoted-iap

Generate Swift code for StoreKit 2 promoted In-App Purchases.

603|51|Updated Oct 29, 2025
One-click install
npx skills add https://github.com/rshankras/claude-code-apple-skills --skill promoted-iap
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: promoted-iap
Source: https://github.com/rshankras/claude-code-apple-skills/tree/main/skills/generators/promoted-iap
Command: npx skills add https://github.com/rshankras/claude-code-apple-skills --skill promoted-iap

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the setup for promoted In-App Purchases, ensuring your premium offerings are visible directly on the App Store product page, increasing discoverability and potential revenue.

Core Features & Use Cases

  • StoreKit 2 Integration: Generates Swift code to handle PurchaseIntent for App Store-initiated purchases.
  • Product Configuration: Sets up PromotedProduct definitions and guidelines for promotional images.
  • Purchase Flow Management: Implements logic to determine whether to show a direct purchase, a paywall, or an onboarding flow.
  • Use Case: You want to make your app's "Pro Subscription" appear prominently on your App Store page, allowing users to purchase it directly from there.

Quick Start

Use the promoted-iap skill to set up a promoted subscription for your app.

Frequently Asked Questions about promoted-iap

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up promoted in-app purchases on the App Store product page?▼

Promoted in-app purchases require Swift code using StoreKit 2 to handle PurchaseIntent, plus configuring product details and promotional images in App Store Connect to display offerings on your product page.

What is a PurchaseIntent in StoreKit 2 for App Store initiated purchases?▼

PurchaseIntent in StoreKit 2 is a mechanism that captures App Store-initiated purchase flows, allowing your Swift code to process transactions when users select promoted products directly from search results or product pages.

Can I show a paywall instead of a direct purchase flow for promoted IAPs?▼

Yes, you can implement purchase flow management logic to determine whether to show a direct purchase, a paywall, or an onboarding flow based on user state detection for promoted in-app purchases.

Do I need promotional images to enable promoted subscriptions on the App Store?▼

Yes, promotional images are required alongside product configuration and PromotedProduct definitions to make your premium offerings visible directly on the App Store product page.

How does StoreKit 2 handle App Store initiated purchases for subscriptions?▼

StoreKit 2 handles App Store initiated subscriptions by generating PurchaseIntent objects that your Swift code intercepts, enabling transaction processing for promoted products selected by users from search results.

When should I use promoted in-app purchases for my App Store product page?▼

Use promoted in-app purchases when you want to increase discoverability and revenue by making premium offerings like Pro Subscriptions visible directly on your App Store product page and in search results.