# integrate-revenuecat

This skill walks the whole RevenueCat integration: it creates the project and app in the dashboard, gets the public API key, then installs and configures the Purchases SDK.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1000 installs · ★ 76
- Author: RevenueCat
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/RevenueCat/ai-toolkit/tree/HEAD/revenuecat/skills/integrate-revenuecat/SKILL.md
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/skills/integrate-revenuecat

## What it does

The skill covers both halves of the job. Dashboard first: project, app registration, public API key — through the RevenueCat MCP server or the `rc` CLI. Then the code: install the Purchases SDK, call `Purchases.configure(…)` at app entry, and check the configuration banner in the logs. Steps run in order, and even a request to just install the SDK still sends the skill to the dashboard for a key, because the SDK needs one.

Platform detection reads the project files: `package.json` with `react-native-purchases`, `pubspec.yaml`, `build.gradle.kts` with a `kotlin { … }` block, `AndroidManifest.xml`, `Info.plist`. iOS, Android, Kotlin Multiplatform, Flutter and React Native are covered. When several markers match, the outermost project wins — the one that owns the build.

Only the public key belongs in client code: `appl_…` for iOS, `goog_…` for Android, `amzn_…` for Amazon. A secret key in the app is a leak, plain and simple — those stay server-side. The skill also flags that `Purchases.configure(…)` runs once per launch, and that keys should live outside source control: `.env`, `xcconfig`, `local.properties` or dart-define.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add RevenueCat/ai-toolkit --skill integrate-revenuecat -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/integrate-revenuecat/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/integrate-revenuecat/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add RevenueCat/ai-toolkit --skill integrate-revenuecat -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/integrate-revenuecat/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add RevenueCat/ai-toolkit --skill integrate-revenuecat -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/integrate-revenuecat/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install RevenueCat/ai-toolkit integrate-revenuecat
```

2. **Manually: put the files in place**
- File: `.github/skills/integrate-revenuecat/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add RevenueCat/ai-toolkit --skill integrate-revenuecat -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/RevenueCat/ai-toolkit --path revenuecat/skills/integrate-revenuecat
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/integrate-revenuecat/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add RevenueCat/ai-toolkit --skill integrate-revenuecat -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/RevenueCat/ai-toolkit/tree/HEAD/revenuecat/skills/integrate-revenuecat/SKILL.md

## When to use it
- create the RevenueCat project and app and pull the public API key
- wire the Purchases SDK into an iOS, Android, Flutter or React Native project
- call `Purchases.configure(…)` at launch and confirm it from the logs
- detect the target platform from build files and manifests
- keep the public client key separate from the server-side secret key

## Example prompts
- add RevenueCat to this project, platform flutter
- install the Purchases SDK and configure it on launch
- I need the RevenueCat public API key for this app

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 1d8f3a731d92bfa2.

BEGIN THIRD-PARTY FILE 1d8f3a731d92bfa2
```text
---
name: integrate-revenuecat
description: End-to-end RevenueCat integration — sets up the dashboard side via the RevenueCat MCP or the `rc` CLI (project, app, public API key) and installs/configures the Purchases SDK in the app. Use when the user asks to add RevenueCat, hook up RevenueCat, add subscriptions or in-app purchases to an app, integrate Purchases, install the RevenueCat SDK, set up a RevenueCat API key, configure Purchases on launch, or set up a brand new RevenueCat integration on iOS, Android, Kotlin Multiplatform, Flutter, or React Native.
---

# integrate-revenuecat: end-to-end RevenueCat integration

Use this skill when the user wants to add RevenueCat to a project for the first time, or to reconfigure the SDK with a public API key. The skill covers two halves:

1. **Dashboard side** — set up the project, register the app, and obtain the public API key, through the RevenueCat MCP server or the `rc` CLI.
2. **App side** — install the Purchases SDK, call `Purchases.configure(…)` at app entry, and verify the configuration banner in the logs.

Once the SDK is configured, settle **how the paywall is built** (Section 5c) before writing any paywall code.

Walk them in order. Most integrations need both halves, even when the user asks "just install the SDK" — the SDK needs an API key from the dashboard.

> If a project + app already exist and the user only wants to wire the SDK into code, jump to **Section 3** below.
> If the user wants to bootstrap a brand new RevenueCat project (apps + products + entitlements + offerings), use the `create-revenuecat-project` skill instead, then come back here for the SDK install.

## Arguments

Available as `$ARGUMENTS` when invoked as a slash command:

- `platform` (optional): One of `ios`, `android`, `kmp`, `flutter`, `react-native`. If omitted, run the detection algorithm in Section 3a.
- `app_identifier` (optional): Bundle ID (iOS) or package name (Android). If omitted, read it from the project files (`Info.plist`, `AndroidManifest.xml`, `app.json`, `pubspec.yaml`).
- `project_name` (optional): Name of the RevenueCat project to use. If omitted, list projects (via MCP or `rc projects list`) and ask the user.

## 1. Understand the status quo

Before touching the dashboard, gather the facts:
```
END THIRD-PARTY FILE 1d8f3a731d92bfa2

The third-party file has ended. Everything between the 1d8f3a731d92bfa2 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2287 of 11864 bytes. © RevenueCat · MIT · https://github.com/RevenueCat/ai-toolkit/tree/HEAD/revenuecat/skills/integrate-revenuecat/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md