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.