---
id: "getting-started/stripe-projects-quickstart"
title: "Stripe Projects quickstart"
description: "Stripe Projects lets you add RevenueCat to your app from inside Stripe, usually without ever visiting the RevenueCat dashboard. With one command, Stripe creates your RevenueCat account, provisions a project and app, and writes your API keys to your environment. This quickstart walks through that flow and shows you where to go next."
permalink: "/docs/getting-started/stripe-projects-quickstart"
slug: "stripe-projects-quickstart"
version: "current"
original_source: "docs/getting-started/stripe-projects-quickstart.mdx"
---

> **AI agents:** This is the Markdown version of a RevenueCat documentation page. For the complete documentation index, see [llms.txt](https://www.revenuecat.com/docs/llms.txt).

[Stripe Projects](https://projects.dev/) lets you add RevenueCat to your app from inside Stripe, usually without ever visiting the RevenueCat dashboard. With one command, Stripe creates your RevenueCat account, provisions a project and app, and writes your API keys to your environment. This quickstart walks through that flow and shows you where to go next.

## What is Stripe Projects?

Stripe Projects is a marketplace of developer services, like RevenueCat, that you or your AI agents provision straight from the command line. You add a service and get its credentials without leaving Stripe. Stripe orchestrates the flow: it holds your identity and routes provisioning requests to each provider. RevenueCat is one of those providers. It accepts the request and returns your credentials.

Your RevenueCat account, customers, and data stay with RevenueCat. You get the same project, dashboard, and SDKs you'd use with any other setup path. Stripe Projects just automates getting you there.

:::info Stripe Projects vs. RevenueCat projects
These are different things. Stripe Projects is Stripe's provisioning marketplace. A [RevenueCat project](https://www.revenuecat.com/docs/projects/overview) is your container for apps, products, and entitlements. Provisioning RevenueCat through Stripe Projects creates a RevenueCat project for you.
:::

## Why add RevenueCat through Stripe Projects?

- **One identity.** Your Stripe login covers RevenueCat. There's no second account to create.
- **Free to start.** RevenueCat is free under [$2,500 monthly tracked revenue (MTR)](https://www.revenuecat.com/pricing). No card required to provision — add payment info in the RevenueCat dashboard later if you outgrow the free tier.
- **One command.** Stripe creates the account, provisions an app, and hands the credentials back to your terminal or agent.
- **No duplicate signup.** Your name, email, country, tax info, and terms acceptance are handled through Stripe.

## Prerequisites

You need the following before you start:

- A [Stripe account](https://dashboard.stripe.com/register) with access to Stripe Projects.
- The [Stripe CLI](https://docs.stripe.com/stripe-cli/install) with the Projects plugin. Install both, then sign in:

```bash
brew install stripe/stripe-cli/stripe
stripe plugin install projects
stripe login
```

- A Stripe project for your app. If you don't have one yet, run `stripe projects init` in your app directory. See Stripe's [Create a project](https://docs.stripe.com/projects#create-a-project) guide.

This guide uses the Stripe CLI. You can run the same flow from an AI coding agent.

## 1. Add RevenueCat to your project

From your project directory, add the RevenueCat app:

```bash
stripe projects add revenuecat/app
```

Stripe shows the service and its price, asks you to accept RevenueCat's terms, and provisions the app:

```text
  revenuecat/app
  ─────────────────────────────────────────────
  Provider      RevenueCat
  Service       app
  Description   RevenueCat app — in-app purchase management,
                subscription analytics, and paywall tools for
                your mobile or web app.
  Pricing       Free

By proceeding, you accept the RevenueCat Terms of Service and agree to
share your name, email, country, and phone number with RevenueCat.

Accepting as: dev@example.com
Accept and provision? [Y/n] y

✓ Connected RevenueCat account (dev@example.com)
○ Provisioning revenuecat/app…
  ├─ ✓ Resource requested
  ├─ ✓ Resource provisioned
  ├─ ✓ Credentials synced
  └─ ✓ Project updated
● revenuecat/app ready

✓ Injected 3 environment variables into .env:
    REVENUECAT_APP_UUID=••••••••
    REVENUECAT_DASHBOARD_URL=••••••••
    REVENUECAT_SECRET_API_KEY=sk_P••••••••
```

You accept RevenueCat's terms inline. There's no separate signup form to fill out.

### New vs. existing RevenueCat account

What happens on the **Connected RevenueCat account** step depends on whether RevenueCat already has an account for your email:

- **No existing account.** RevenueCat creates one for you inline. You never see a signup form.
- **Existing account.** Stripe sends you to `app.revenuecat.com/stripe-projects/connect` to log in and confirm the link. After you confirm, the CLI finishes provisioning automatically, and the new app appears in your existing project.

## 2. Find your credentials

Stripe writes three environment variables to your project's `.env` file, and keeps an encrypted copy in its credential vault:

| Variable                    | What it is                                                                   |
| --------------------------- | ---------------------------------------------------------------------------- |
| `REVENUECAT_APP_UUID`       | The unique ID of the RevenueCat app that was provisioned.                    |
| `REVENUECAT_DASHBOARD_URL`  | A direct link to your project in the RevenueCat dashboard.                   |
| `REVENUECAT_SECRET_API_KEY` | A secret key for the [RevenueCat REST API v2](https://www.revenuecat.com/api-v2). Keep it server-side. |

`REVENUECAT_SECRET_API_KEY` is a secret key for server-to-server calls. Never ship it in a mobile or web client. To configure a RevenueCat SDK, you use a separate **public** API key from the dashboard. See [API Keys & Authentication](https://www.revenuecat.com/docs/projects/authentication) for the difference.

## 3. Open your RevenueCat dashboard

To open your project in the dashboard, run:

```bash
stripe projects open revenuecat
```

This signs you in through a short-lived, single-use link, with no password required. The link can't be bookmarked or reused, so run the command again whenever you need a fresh one.

:::tip Logging in to RevenueCat directly
`stripe projects open revenuecat` is the easiest way in. Accounts created through Stripe Projects don't have a password, so to sign in at app.revenuecat.com directly, [set a password](https://app.revenuecat.com/forgot_password) first. If you linked an existing RevenueCat account, keep using your current password.
:::

## Manage your provisioned apps

Use the Stripe CLI to manage what you've provisioned:

- `stripe projects status` lists the RevenueCat resources on your project.
- `stripe projects add revenuecat/app` provisions another app on the same RevenueCat account.
- `stripe projects remove revenuecat/app` **permanently deletes the app** from RevenueCat and removes its credentials from `.env`. This can't be undone — if you just want to stop being billed, remove your payment method in the RevenueCat dashboard instead.
- `stripe projects env` shows the environment variables in the active environment.

For the full command set, see Stripe's [Projects CLI reference](https://docs.stripe.com/projects#command-reference).

## How billing works

RevenueCat billing lives in RevenueCat, not Stripe. Provisioning through Stripe Projects gets you set up faster — it doesn't route billing through Stripe.

- **Free to start.** RevenueCat is free under [$2,500 monthly tracked revenue (MTR)](https://www.revenuecat.com/pricing). You don't need to add a payment method to provision an app, and the CLI shows **Free** on the summary card.
- **Pay later, if needed.** As your usage approaches the free tier limit, add a payment method in the RevenueCat dashboard. Invoices appear there, not on your Stripe invoice.
- **One account.** Provisioning another `revenuecat/app` doesn't create a new subscription — everything lives on the same RevenueCat account.

## Troubleshooting

**I signed up through Stripe and can't log in to RevenueCat.** Accounts created through Stripe Projects don't have a password yet. The quickest way in is `stripe projects open revenuecat`, which signs you in without one. To log in at app.revenuecat.com directly, [set a password](https://app.revenuecat.com/forgot_password) using the same email you used with Stripe.

**Where do I see my RevenueCat invoice?** Billing lives in RevenueCat, not Stripe. Once you exceed the free tier and add a payment method, invoices appear in the RevenueCat dashboard. See [Billing and account settings](https://www.revenuecat.com/docs/welcome/set-up-revenuecat/account-management) for details.

**How do I cancel?** If you're on the free tier with no payment method on file, there's nothing to cancel — you can stop using RevenueCat at any time and your data stays put. Otherwise, you have two options depending on what you want:

- **Stop being billed, keep your data.** Remove your payment method in the RevenueCat dashboard. Your project and data stay intact and fall back to the free tier.
- **Delete the app entirely.** Run `stripe projects remove revenuecat/app`. This permanently deletes the app from RevenueCat and can't be undone. See Stripe's [Remove a service](https://docs.stripe.com/projects#remove-a-service) documentation.

## Next steps

You've provisioned RevenueCat through Stripe Projects, and your credentials are in your environment.

- [Add the RevenueCat SDK to your app](https://www.revenuecat.com/docs/getting-started/quickstart). Get your public SDK key from the dashboard, then follow the SDK Quickstart.
- [Configure your products](https://www.revenuecat.com/docs/projects/configuring-products) so you have something to sell.
- [Display a paywall](https://www.revenuecat.com/docs/tools/paywalls/displaying-paywalls) and [make your first purchase](https://www.revenuecat.com/docs/getting-started/making-purchases).
- [Test your integration](https://www.revenuecat.com/docs/test-and-launch/debugging) before going live.