Skip to content
Skills Library
Programming · Automation

rc-setup

/rc-setup

Use this skill when setting up a RevenueCat project for Android: creating the app in the dashboard, uploading the Google Play service account credentials, connecting Real Time Developer Notifications, configuring entitlements and offerings, and getting the public SDK API key for the Android app.

Licence
MIT
Last repository change
11.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
1
Deprecation

No signals detected. Repository changed on 11.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Use this skill when setting up a RevenueCat project for Android: creating the app in the dashboard, uploading the Google Play service account credentials, connecting Real Time Developer Notifications, configuring entitlements and offerings, and getting the public SDK API key for the Android app.

Original author description

Use this skill when setting up a RevenueCat project for Android: creating the app in the dashboard, uploading the Google Play service account credentials, connecting Real Time Developer Notifications, configuring entitlements and offerings, and getting the public SDK API key for the Android app.

How it works

  1. Phase 1: Discovery
  2. Phase 2: Plan
  3. Phase 3: Execute
  4. Phase 4: Verify
  5. References
Original SKILL.md headings · 153 lines, 1,206 words
SKILL.md preview
---
name: rc-setup
description: "Use this skill when setting up a RevenueCat project for Android: creating the app in the dashboard, uploading the Google Play service account credentials, connecting Real Time Developer Notifications, configuring entitlements and offerings, and getting the public SDK API key for the Android app."
license: Apache-2.0; see LICENSE
metadata:
  author: RevenueCat
  source: revenuecat-handbook chapter 2
  keywords:
  - android
  - revenuecat
  - setup
  - dashboard
  - api-key
  - service-account
---

# RevenueCat Android Setup

Configure a RevenueCat project so the Android SDK can fetch offerings, validate purchases, and grant entitlements. This skill covers the dashboard side of setup and the service account connection to Google Play.

The scope stops at "dashboard ready, API key in hand." SDK initialization code belongs to the [rc-configuring-the-sdk](../rc-configuring-the-sdk/) skill.

## Phase 1: Discovery

Confirm these items before you touch the RevenueCat dashboard. Missing any of them will block the connection step.

| Prerequisite | Where it lives | Why RevenueCat needs it |
|---|---|---|
| Google Play Console app | Play Console | Dashboard connects by package name |
| Package name | Play Console app listing | Must match your Android app exactly |
| In-app products or subscriptions | Play Console monetization | RevenueCat imports the catalog |
| Base plans for subscriptions | Play Console subscription | Billing Library 6+ requires them |
| Google Cloud service account JSON | Google Cloud Console | RevenueCat authenticates to the Play Developer API |
| Play Console account permissions | Play Console users and permissions | View app information and download bulk reports (read-only); View financial data, orders, and cancellation survey responses; Manage orders and subscriptions; Manage store presence |

Ask the user:

- Is the app already published on Play (even as internal testing)?
- Are products live in Play Console, or still drafts?
- Do you have the service account JSON, or do you need the creation steps?

If products do not exist yet, pause. Product creation is a Play Console task outside this skill.

## Phase 2: Plan

Pick the route that matches the user's state.

| State | Route |
|---|---|
| No RevenueCat account | Start at Step 1, create account and project |
| Account exists, no Android app in project | Start at Step 2, add Android app |
| App exists, Play not connected | Jump to Step 3, upload service account |
| Play connected, no entitlements or offerings | Jump to Step 4 |
| Everything configured, need the API key | Jump to Phase 4 verification |

The default flow below runs end to end. Skip steps the user has already completed.

## Phase 3: Execute

### Step 1: Create the RevenueCat project and Android app

1. Sign up or log in at `app.revenuecat.com`.
2. Create a project. One project can hold Android, iOS, and web apps for the same product.
3. Inside the project, add an Android app. Enter the Play Console package name.

RevenueCat generates a public SDK API key per platform. You will copy the Android key at the end. Do not reuse iOS or web keys in the Android app.

### Step 2: Create a Google Cloud service account (if needed)

In Google Cloud Console, in the project that will own the service account (Play Console no longer needs a linked Cloud project):

1. Enable the Google Play Android Developer API, the Google Play Developer Reporting API, and the Cloud Pub/Sub API.
2. Create a service account and grant it Pub/Sub Editor and Monitoring Viewer.
3. Create a JSON key for the service account and download it.

In Play Console, under Users and permissions:

1. Invite the service account email.
2. Grant app-level access to the app.
3. Grant those four account permissions.

### Step 3: Connect Google Play in RevenueCat

In the RevenueCat dashboard, open the Android app settings:

1. Confirm the package name matches Play Console.
2. Upload the service account JSON key file.
3. Save.

RevenueCat validates the credential by calling the Play Developer API. If validation fails, the common causes are missing API enablement, wrong project, or the service account not yet propagated in Play (allow up to 36 hours; editing and saving any product description in Play Console often speeds this up).

### Step 3b: Connect Real Time Developer Notifications

RevenueCat strongly recommends connecting Google Real Time Developer Notifications (RTDN), and requires it for `DEFERRED` plan changes and for one time product refund and void tracking.

1. In the RevenueCat Play app settings, click Connect to Google to get a Pub/Sub topic ID.
2. In Play Console, go to Monetize > Monetization setup > Real Time Developer Notifications, paste the topic, and choose "Get all notifications for subscriptions and one-time products" (RevenueCat's guide shows it as "Subscriptions, voided purchases, and all one-time products").
3. Send a test notification and confirm the RevenueCat dashboard shows "Last received".

### Step 4: Create entitlements

Entitlements are the access levels your app checks. Define them once, reference them everywhere in client code.

In the dashboard under Entitlements, create one per access tier. Most apps ship with a single entitlement.

| Identifier | Description |
|---|---|
| `pro_access` | Unlocks premium features |
| `team_access` | Unlocks team features (second tier, optional) |

Use a stable identifier. Renaming an entitlement later means rewriting every feature gate.

### Step 5: Import products and attach entitlements

Under Products, click Import. RevenueCat pulls the Play catalog through the connected service account.

1. Select each product you want RevenueCat to manage.
2. Attach each product to an entitlement. Purchasing the product grants that entitlement.

A single entitlement can back many products (monthly, annual, lifetime all unlock `pro_access`).

### Step 6: Create an offering

Offerings drive what a user sees on the paywall. One offering groups multiple packages.

Under Offerings:

1. Create an offering (for example, `default`).
2. Add packages. Pick a package type (Monthly, Annual, Lifetime, or custom) and assign a product.
3. Make one offering the Default offering (the SDK returns it as `offerings.current`).

The Android SDK fetches `offerings.current` to show the default paywall. Swap the current offering later from the dashboard without shipping an app update.

### Step 7: Copy the Android API key

In the Android app settings, copy the public SDK API key. This value is the second argument to `PurchasesConfiguration.Builder`. The skill configuring-the-sdk uses it.

```kotlin
// Handed off to configuring-the-sdk
val revenueCatApiKey = "goog_xxxxxxxxxxxxxxxxxxxxxxxx"
```

## Phase 4: Verify

Confirm the dashboard and Play Console are wired together before moving to SDK work.

| Check | How to verify | Pass signal |
|---|---|---|
| Service account accepted | RevenueCat app settings, Google Play section | Shows connected with a green indicator |
| Real Time Developer Notifications connected | RevenueCat app settings, Google Play section | Shows "Last received" after a test notification |
| Products imported | Products tab in dashboard | Play products appear with live prices |
| Entitlement attachments | Open each product | Shows the attached entitlement |
| Default offering | Offerings tab | One offering marked Default |
| Package product links | Open the current offering | Each package shows a product identifier |
| API key scope | Project settings, API keys | Android key is distinct from iOS and web keys |

Ask the user to confirm each row. If a product shows no price, the service account is connected but the product is not active in Play. Fix the Play listing, then re-import.

Hand off to [rc-configuring-the-sdk](../rc-configuring-the-sdk/) with:

- The Android API key
- The current offering identifier
- The entitlement identifiers the app will check

## References

- [Full chapter](https://www.revenuecat.com/guides/revenuecat-android-sdk/setting-up-revenuecat)

Versions

RepositoryScoreLicence
This page · RevenueCat/rc-claude-code-plugin100MIT
RevenueCat/ai-toolkit100MIT

Database snapshot: 13.11.2026 · package version 59258e9a2842 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 2 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100rc-understanding-revenuecat
    Use this skill to orient an agent to the RevenueCat Android SDK (10.x) architecture. Covers how RevenueCat reorganizes BillingClient, Google Play Developer API, and RTDN into a single SDK, and how Products, Packages, Offerings, Entitlements, and CustomerInfo connect.
  • 100create-revenuecat-project
    Set up a complete RevenueCat project from scratch — creates apps, products, entitlements, offerings, and packages in the correct order. Use when the user wants to create a new RevenueCat project, configure in-app purchases, set up subscriptions or monetization, or bootstrap IAP…
  • 100integrate-revenuecat
    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…
  • 100rc-catalog-management
    Use this skill when managing the Android product catalog through the Play Console and the RevenueCat dashboard. Covers the two sided catalog flow (create in Play Console, import or map in RevenueCat), entitlement and offering maintenance, and why you do not call the Google Play…
  • 95create-app
    Step-by-step guide for setting up an iOS or Android app in RevenueCat. Use when configuring a new app with RevenueCat.
  • 95asc-revenuecat-catalog-sync
    Reconcile App Store Connect subscriptions and in-app purchases with RevenueCat products, entitlements, offerings, and packages using asc and RevenueCat MCP. Use when setting up or syncing subscription catalogs across ASC and RevenueCat.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.