> ## Documentation Index
> Fetch the complete documentation index at: https://docs.newly.app/llms.txt
> Use this file to discover all available pages before exploring further.

# How Subscription Setup Works

> What Newly automates when you add subscriptions to your app

Newly handles most of the RevenueCat setup automatically. Here's what happens when you add subscriptions to your app.

## One-click setup

When you ask the AI to add a paywall or subscriptions, the flow is:

<Steps>
  <Step title="Connect your RevenueCat account">
    An OAuth popup lets you connect your RevenueCat account. This gives Newly permission to create products and fetch API keys on your behalf.
  </Step>

  <Step title="Choose your price">
    You pick a monthly subscription price (e.g. \$9.99/month). Newly does the rest.
  </Step>

  <Step title="Everything gets created automatically">
    Newly creates the following in your RevenueCat dashboard:

    * An **entitlement** (always named "pro")
    * A **product** with your chosen price
    * An **offering** and **package** linking them together
    * **App Store** and **Play Store** apps in RevenueCat
    * **App Store Connect** subscriptions and products

    Then the AI agent generates all the code in your app:

    * `SubscriptionContext.tsx` — provider with RevenueCat SDK
    * A paywall screen at `/paywall`
    * Integration into your onboarding flow
    * SDK API keys in `app.json`
  </Step>
</Steps>

## What gets automated

| Step                          | Manual?    | Notes                                    |
| ----------------------------- | ---------- | ---------------------------------------- |
| RevenueCat account connection | One click  | OAuth flow                               |
| Price selection               | You choose | Monthly billing, one price per product   |
| Product catalog creation      | Automatic  | Entitlement, product, offering, package  |
| App Store app creation in RC  | Automatic  | iOS + Android                            |
| App Store Connect products    | Automatic  | Subscriptions and IAP configuration      |
| SDK key fetching              | Automatic  | Test + production keys                   |
| Code generation               | Automatic  | Context, paywall, onboarding integration |
| Paywall UI                    | Automatic  | AI generates based on your app           |

## The "pro" entitlement

Newly uses a single entitlement called **"pro"** for all subscriptions. Custom entitlement names are not supported. If a different name is accidentally set, the system auto-corrects it to "pro".

<Note>
  You don't need to worry about entitlement names — the system handles this automatically. If you see "pro" in your RevenueCat dashboard, that's expected.
</Note>

## Navigation order

When you have authentication, onboarding, and a paywall, Newly enforces a deterministic navigation order:

1. **Authentication** — user signs in or creates account
2. **Onboarding** — app onboarding screens
3. **Paywall** — subscription screen

This order is enforced regardless of the sequence you set things up in.