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

# Billing, credits, and usage limits

> How plans, credits, checkout flows, and quota gates behave in Blueprints.

Blueprints uses credit-based billing with hard quota gates. If a request would exceed your available credits, the action is blocked and the app shows an upgrade flow.

## Plans and included credits

* **Community (Free)**: 2,000 credits/month, up to 10 total blueprints, up to 2 running blueprints
* **Pro**: \$20/month, 10,000 credits/month, unlimited total blueprints, up to 25 running blueprints
* **Teams**: custom limits and pricing via sales

Plan limits are enforced server-side.

## Credit top-ups

Pro users can buy one-time top-up packs:

* **1k**: 1,000 credits for \$10
* **5k**: 5,000 credits for \$45 (10% lower unit price)
* **25k**: 25,000 credits for \$212.50 (15% lower unit price)

Top-up credits are additive to your recurring plan credits.

## What the app displays

In app settings and header:

* A credit indicator shows remaining percentage for your current cycle
* The billing card shows recurring plan credits separately from top-up balance
* Running blueprint usage is shown against your plan limit
* If Pro is set to cancel, the UI changes from **Renews** to **Ends** with the end date

## Quota gate behavior

Before credit-consuming operations run, Blueprints reserves estimated usage. After completion, usage is finalized against actual usage.

If quota is exhausted:

* API returns a quota error
* The app shows an "out of credits" banner with upgrade CTA
* The operation does not continue until credits are available

## Checkout and portal behavior

Upgrade and top-up flows open hosted checkout. Return URLs are validated against allowed app origins before redirect URLs are accepted.

After checkout return:

* The app refreshes billing state
* A one-time success/cancel toast is shown in the same browser tab that started checkout
* Temporary checkout query params are removed from the URL