跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
开发与测试

capacitor-in-app-purchases

Guides the agent through setting up in-app purchases in Capacitor apps. Covers App Store Connect and Google Play Console product configuration, plugin selection (Capawesome Purchases vs. RevenueCat), plugin installation and platform setup, purchase flows for subscriptions and consumables, receipt validation, restore purchases, handling unfinished transactions, and testing with sandbox and StoreKit environments. Do not use for non-Capacitor mobile frameworks, Stripe payment processing, or physical goods checkout.

capawesome-team · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add capawesome-team/skills --skill capacitor-in-app-purchases

技能说明


name: capacitor-in-app-purchases description: "Guides the agent through setting up in-app purchases in Capacitor apps. Covers App Store Connect and Google Play Console product configuration, plugin selection (Capawesome Purchases vs. RevenueCat), plugin installation and platform setup, purchase flows for subscriptions and consumables, receipt validation, restore purchases, handling unfinished transactions, and testing with sandbox and StoreKit environments. Do not use for non-Capacitor mobile frameworks, Stripe payment processing, or physical goods checkout." metadata: author: capawesome-team source: https://github.com/capawesome-team/skills/tree/main/skills/capacitor-in-app-purchases

Capacitor In-App Purchases

Set up in-app purchases and subscriptions in Capacitor apps, covering store configuration, plugin integration, purchase flows, receipt validation, and testing.

Prerequisites

  1. Capacitor 6, 7, or 8 app (Capawesome Purchases requires Capacitor 8+; RevenueCat requires Capacitor 8+).
  2. Node.js and npm installed.
  3. For iOS: A paid Apple Developer Program membership, Xcode installed, and an app created in App Store Connect.
  4. For Android: A Google Play Developer account, Android Studio installed, and an app created in Google Play Console.

Agent Behavior

  • Guide step-by-step. Walk the user through the process one step at a time. Never present multiple unrelated questions at once.
  • Auto-detect before asking. Check the project for platforms (android/, ios/), package.json dependencies, and Capacitor version. Only ask the user when something cannot be detected.
  • One decision at a time. When a step requires user input, ask that single question, wait for the answer, then continue.
  • Present clear options. Provide concrete choices (e.g., "Which purchases plugin do you want to use? (1) Capawesome Purchases (2) RevenueCat") instead of open-ended questions.

MCP Server

The Capawesome MCP server serves the current Capawesome documentation, so it is always ahead of the guidance bundled with this skill.

  • If the Capawesome MCP tools are available, call search_docs for the topic and read the matching page with get_doc_page before applying the guidance below. Where the two disagree, follow the documentation.
  • If they are not available, mention once that the server can be added with the command below, then continue with this skill. Never block on it.
claude mcp add --transport http capawesome "https://mcp.capawesome.io/mcp"

The documentation tools need no account and no token. See the capawesome-mcp skill for full setup, including the Capawesome Cloud tools.

Procedures

Step 1: Analyze the Project

Auto-detect the following by reading project files — do not ask the user for information that can be inferred:

  1. Platforms: Check which directories exist (android/, ios/). These are the platforms to configure.
  2. Capacitor version: Read @capacitor/core version from package.json.
  3. Existing purchases plugins: Check if @capawesome-team/capacitor-purchases, @revenuecat/purchases-capacitor, or any other in-app purchase plugin is already in package.json. If found, inform the user and ask whether to continue with the existing plugin or switch.

Step 2: Configure Products in App Store Connect (iOS)

Skip if ios/ does not exist.

Read references/app-store-connect-setup.md and guide the user through creating in-app purchase products and subscriptions in App Store Connect. This covers:

  • Accepting required developer agreements
  • Verifying business configuration (Paid Apps Agreement, bank account, tax forms)
  • Creating in-app purchase products (consumables, non-consumables, subscriptions)
  • Subscription group setup
  • Product status requirements

Step 3: Configure Products in Google Play Console (Android)

Skip if android/ does not exist.

Read references/google-play-console-setup.md and guide the user through creating in-app purchase products in Google Play Console. This covers:

  • Completing compliance and metadata requirements
  • Creating in-app products and subscriptions
  • Configuring pricing and tax settings
  • Activating products

Step 4: Choose a Purchases Plugin

Ask the user which plugin to use:

  1. Capawesome Purchases (@capawesome-team/capacitor-purchases) — Lightweight, no third-party backend dependency. Requires a Capawesome Insiders license. Server-side receipt validation is the developer's responsibility.
  2. RevenueCat (@revenuecat/purchases-capacitor) — Full backend service with server-side receipt validation, entitlement management, analytics, and integrations. Requires a RevenueCat account.

Default recommendation: Capawesome Purchases for apps that already have a backend for receipt validation or want to avoid third-party dependencies. RevenueCat for apps that want managed receipt validation and subscription analytics out of the box.

Step 5: Install and Configure the Plugin

Based on the user's choice in Step 4:

  • Capawesome Purchases: Read references/capawesome-purchases-setup.md and follow the installation and platform configuration steps.
  • RevenueCat: Read references/revenuecat-setup.md and follow the installation and platform configuration steps.

Step 6: Implement Purchase Flows

Based on the user's plugin choice:

  • Capawesome Purchases: Read references/capawesome-purchases-implementation.md and add the purchase code to the project.
  • RevenueCat: Read references/revenuecat-implementation.md and add the purchase code to the project.

Adapt imports and code structure to match the user's framework (Angular, React, Vue, etc.).

The implementation covers:

  1. Fetching product details
  2. Purchasing a product
  3. Finishing transactions (Capawesome)
阅读完整来源 ↗