Skip to main content
skill CX Codex

revenuecat-testing — Claude Code skill: what it does, how to install

revenuecat-testing builds a structured QA plan for RevenueCat in-app subscriptions, verifies sandbox events, and debugs purchase restore flows.

MIT ★ 674 updated 2026-10-29

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add evanca/flutter-ai-rules
/plugin install flutter-ai-skills@flutter-ai-rules
Open on GitHub

What revenuecat-testing does

This skill guides developers through systematic verification of RevenueCat integrations before release. It anchors tests to concrete signals: dashboard events such as INITIAL_PURCHASE, TRANSFER, or PRODUCT_CHANGE, specific period_type values, and SDK debug logs.

The coverage spans six key areas: subscription lifecycles, account identification, purchase transfer edge cases, paywalls, web billing, and experiment readiness. It also points Flutter projects to the official Purchase Tester sample app to isolate configuration errors from app logic.

Testing refunds in the iOS sandbox is impossible directly through StoreKit; Apple handles refund requests through support channels, meaning cancellation events may take a full day to reflect.

What it helps with

  • build an end-to-end IAP QA checklist with expected dashboard events
  • debug account switching conflicts and purchase transfer issues
  • troubleshoot Invalid Product Identifiers before testing store flows
  • verify dynamic offerings and SDK requirements before starting an experiment

Example prompts for the agent

  • Generate a QA plan for testing auto-renewing subscriptions and trials on Android and iOS
  • Help me debug why a purchase restore did not trigger a TRANSFER event
  • Check if our Flutter paywall setup is ready for a RevenueCat experiment

How to install revenuecat-testing

1Plugin marketplace

/plugin marketplace add evanca/flutter-ai-rules
/plugin install flutter-ai-skills@flutter-ai-rules

This installs the whole flutter-ai-skills plugin with all its skills

2Skills CLI (Vercel)

npx skills add evanca/flutter-ai-rules --skill revenuecat-testing -a claude-code

3Manually: put the files in place

~/.claude/skills/revenuecat-testing/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/revenuecat-testing/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about revenuecat-testing

How do I install revenuecat-testing in Claude Code?

Add the repository and install the plugin using /plugin marketplace add evanca/flutter-ai-rules followed by /plugin install flutter-ai-skills@flutter-ai-rules.

What does revenuecat-testing do?

It maps your billing setup to test cases, diagnostic steps, and verifiable dashboard events across mobile and web platforms.

Can I test in-app purchase refunds inside the iOS sandbox?

StoreKit sandbox does not support direct refunds, so Apple routes them through customer support and the cancellation event can take up to 24 hours to appear.

Source text

SKILL.md · MIT
---
name: revenuecat-testing
description: "Use when testing RevenueCat purchases/subscriptions, setting up sandbox testing, debugging a purchase/restore/trial, verifying entitlements or events, checking an app is ready for a RevenueCat experiment, or writing an IAP QA plan."
license: MIT
---

# RevenueCat Testing

Help a developer systematically verify their RevenueCat integration works before shipping — turning "I added RevenueCat, does it actually work?" into a concrete, checkable QA plan. The full use-case matrix, methods, platform differences, and the verifiable signal for each case live in `references/use_cases.md`. Read it for exact event names and preconditions; this file is the operating guide.

**The organizing principle:** every RevenueCat behavior has a **verifiable signal** — a specific dashboard event (`INITIAL_PURCHASE`, `TRANSFER`, `EXPIRATION`, `PRODUCT_CHANGE`, `CANCELLATION`), a `period_type` value, or a CustomerInfo/debug-log state. A test isn't "did the app not crash"; it's "did the expected event appear in the customer's history with the right fields." Always tie a test to its signal, or it isn't really testing anything.

## How to use this skill

1. **Get the setup facts**: platform(s) (iOS / Android / cross-platform / web billing), SDK (native, RN, Flutter, etc.), whether they've enabled debug logs and sandbox accounts yet, and what specifically they're trying to verify or why they think something is broken.
2. **Establish prerequisites first** — most "purchases don't work" reports are config problems visible before any purchase:
   - Debug logs on *before* `configure()` (iOS `Purchases.logLevel = .debug`; Android `setLogLevel(LogLevel.DEBUG)`), and check for **"Invalid Product Identifiers"** and error-level logs. Fix those before touching purchase flows.
   - Sandbox environment set up; multiple sandbox test IDs ready if any account-switching is in scope.
   - Point them at the debug overlay (`debugRevenueCatOverlay()` / `DebugRevenueCatBottomSheet`) to preview offerings and run test purchases quickly.
3. **Map their goal to use cases** from the reference and produce the plan (below).

**Reference implementation (especially for Flutter):** RevenueCat ships an official **Purchase Tester** sample app at `github.com/RevenueCat/purchases-flutter/tree/main/revenuecat_examples/purchase_tester`. It's a runnable app exercising the flows this skill tests — dedicated screens for product change (`product_change_testing_screen.dart`), paywalls and paywall-footer, customer center, virtual currency, winback offers, and custom paywall-impression testing — plus an end-to-end integration test at `integration_test/app_test.dart`. Point Flutter users there to (a) run a known-good build to isolate whether a bug is in their code vs. their store/RevenueCat config, and (b) model their own `integration_test` widget tests on `app_test.dart`. For non-Flutter SDKs, RevenueCat has equivalent Purchase Tester apps in each SDK repo.

## The six testing domains

Pull the specific rows from `references/use_cases.md`; here's the shape so you know what to cover:

1. **Subscription lifecycle** — purchase, free trial/intro offer (`period_type` = `TRIAL`/`INTRO`), renewal, upgrade/downgrade (`PRODUCT_CHANGE`), cancellation, expiration, refund. **Platform gotcha to always flag:** iOS sandbox refunds are not possible — the App Store routes users to Apple support and the `CANCELLATION`/`CUSTOMER_SUPPORT` event can take ~24h; Google Play refunds are dashboard-driven.
2. **Configuration** — anonymous vs identified App User IDs (verify via debug log + CustomerInfo), offering display, and login/logout — where the key risk is **unintended data merging** between accounts.
3. **Restoring flow** — the account-switching/transfer matrix. This is the highest-value, most-bug-prone area: `syncPurchases()`, restore-to-new-ID, the three-ID conflict case (transfer succeeds for the empty ID, errors for the one that already owns the sub), and transfer-disabled behavior. The signal throughout is whether a `TRANSFER` event fires (or correctly does *not*).
4. **Paywalls** — display & purchase, localization (device/store-account country → language + localized price), and intro-offer eligibility display for fresh users.
5. **RevenueCat Billing (web)** — purchase, trial auto-conversion, expiration.
6. **Before an experiment** — the app must render the SDK's *current* offering (or the placement's current offering), never a hard-coded one, or customers don't split evenly between variants; and the installed SDK must meet the feature-gate minimum for anything the experiment relies on. Setting up and running the experiment itself is the RevenueCat AI Toolkit's `revenuecat-experiments` skill.

## Deliverables

- **QA test plan** — a checklist of the use cases relevant to their app (skip web billing if they're mobile-only, skip trials if they have none, add the pre-experiment checks when an experiment is planned), each row as: *action → expected event/signal → where to see it*. This is the primary output; make it copy-pasteable into a QA doc or issue tracker.
- **Debugging a specific failure** — diagnose against the reference: is it a prereq problem (invalid product IDs, logs off, wrong sandbox account)? a wrong-signal expectation (e.g. expecting `TRANSFER` when transfer is disabled)? a platform difference (iOS refund can't be sandbox-tested)? Name the expected event and where it should appear, then work backward from what they actually see.
- **Restore/transfer walkthrough** — when the user is confused about account switching, walk the specific ID configuration and the expected `TRANSFER`-or-error outcome for each ID, since this is the area the docs spend the most care on.
- **Sandbox setup guidance** — the prerequisites section, adapted to their platform and SDK.

Tie every recommendation to the verifiable signal in `references/use_cases.md` — the event cheat-sheet at the bottom of that file maps each event to what it proves.

© Ivanna Kaceviča · MIT · evanca/flutter-ai-rules

Similar skills

All skills for Mobile →

From the same set39

The whole set →
firebase-crashlytics Skill teaches the agent to set up Firebase Crashlytics in Flutter projects: catch fatal and non-fatal errors, log async exceptions, add custom keys, and upload obfuscated build symbols. CX Codex +1 ★ 674repo stars firebase-in-app-messaging Guides Firebase In-App Messaging setup in Flutter: trigger and suppress popups during sensitive flows, configure GDPR opt-in collection, and run tests via test device IDs. CX Codex +1 ★ 674repo stars firebase-analytics firebase-analytics is a Claude Code skill for configuring Firebase Analytics in Flutter apps. It activates for event logging, user properties, funnels, and screen-view tracking. CX Codex +1 ★ 674repo stars patrol-e2e-testing patrol-e2e-testing is a skill for building and running Patrol 4.x end-to-end tests for Flutter apps, covering user flows, OS permission dialogs and cross-platform checks. CX Codex +1 ★ 674repo stars firebase-app-check This skill guides Firebase App Check setup in Flutter, including provider choice, debug tokens, token refresh, and enforcement rollout. CX Codex +1 ★ 674repo stars flutter-best-practices flutter-best-practices is a Claude Code skill with rules for Flutter and Dart: layers, feature folders, widget choices, and tests. The agent reads the reference file matching the task. CX Codex +1 ★ 674repo stars flutter-app-architecture flutter-app-architecture enforces layered Flutter architecture with MVVM, repositories, services, and unidirectional data flow. CX Codex +1 ★ 674repo stars riverpod This skill guides Riverpod work in Flutter and Dart, from provider setup to lifecycle handling and tests. Use it when an agent needs project-specific state-management guidance. CX Codex +1 ★ 674repo stars

Project sponsors

Companies that keep this analytics open