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

# Credit and App Size Limits

> Learn about Mocha credit allowances and app size limitations

In Mocha, there are two limits that you should be aware of:

1. [Credit limits](#credit-limits)
2. [App size limits](#app-size-limits)

## Credit Limits

### How many credits do I get?

Everyone starts with **20 free credits** on the Free tier.

On a Bronze, Silver or Gold plan you receive **1,500, 4,500, and 25,000 credits** per month respectively. These refill every billing cycle.

* 🥉**Bronze**: 1,500 credits per month
* 🥈**Silver**: 4,500 credits per month
* 🥇**Gold**: 25,000 credits per month

Unused **subscription credits** can accumulate up to **2× your monthly subscription allowance** (base plan + any credit bundles). If you're already at the cap when your billing cycle refreshes, you won't receive additional subscription credits until you spend some.

Example: A plan with **1,500 credits/month** can save up to **3,000 subscription credits**.

### How do you count credits?

We only deduct credits when an AI operation (code generation or edit) succeeds. You can track your credit balance by clicking the main dropdown menu in the top left corner.

### Do credits roll over from month to month?

Subscription credits refresh each billing cycle. Unused subscription credits can carry over up to **2× your monthly subscription allowance** (base plan + bundles). Purchased and gifted credits are kept forever and are only used after subscription credits run out.

### I used all my credits by clicking "Fix with AI", what should I do?

You can email us at [support@getmocha.com](mailto:support@getmocha.com) from the email associated with the account. In general, only use Fix with AI once or twice, if the AI can't fix it automatically you should try a different strategy or ask for help in our [Discord](https://discord.gg/y998ff2XTv).

### How can I purchase more credits?

You should subscribe to a higher plan. If you want to buy one-off credits, let us know at [support@getmocha.com](mailto:support@getmocha.com), we are debating adding this as an option if there is demand.

## App Size Limits

Mocha's AI agent can handle apps of virtually any size, with limits varying by subscription tier:

* 🥉**Bronze**: Limited app size (suitable for small to medium projects)
* 🥈**Silver**: Nearly unlimited app size
* 🥇**Gold**: Even larger app size, and uses our greedy agent mode.

<Tip>
  Starting with the Silver tier, you can build large, complex applications without worrying about size constraints. The limits are set so high that they're effectively unlimited for most use cases.
</Tip>

### I keep seeing "Project size exceeds maximum allowed bronze tier limits". What can I do?

If you're on the Bronze tier and encountering size limits, upgrading to Silver or Gold will give you nearly unlimited capacity to continue building your app.

The Bronze tier is designed for smaller projects and learning. For production applications or larger codebases, we recommend upgrading to Silver or Gold for the best experience.

***

## Credits FAQ

<AccordionGroup>
  <Accordion title="What exactly are credits used for?">
    Credits are consumed when you ask Mocha's AI to make changes to your app. This includes generating new features, editing existing code, fixing bugs, and any other AI-powered modifications. Credits are also used for [Discuss Mode](/basics/discuss-mode).

    Credits are **not** used for:

    * Browsing your project
    * Using [Direct Edit Mode](/basics/direct-edit) to change text
    * Viewing or managing your database
    * Publishing your app
    * Restoring a version
  </Accordion>

  <Accordion title="How many credits does it take to build something?">
    It depends on the complexity of your request. Here are some rough examples:

    * **Simple text or styling change:** 5-15 credits
    * **Adding a new component or section:** 15-40 credits
    * **Building a new page:** 30-60 credits
    * **Adding a complex feature with database:** 50-100+ credits
    * **Using Discuss Mode:** Dynamic credits (same as code mode)

    Smaller, focused requests typically use fewer credits than large, complex ones. We recommend breaking big features into smaller steps.
  </Accordion>

  <Accordion title="Do credits roll over from month to month?">
    **Subscription credits** refresh each billing cycle and can accumulate up to **2× your monthly subscription allowance** (base plan + bundles). If you're already at the cap at the time of renewal, you won't receive additional subscription credits until you spend some.

    **Purchased credits** (one-time purchases) and **gifted credits** are kept forever, don't expire, and are only used when subscription credits have been used up.
  </Accordion>

  <Accordion title="What happens when I run out of credits mid-project?">
    When you run out of credits, you won't be able to make AI-powered changes until your credits refresh or you get more. However, you can still:

    * View and browse your project
    * Use [Direct Edit Mode](/basics/direct-edit) for simple text changes
    * Publish your app
    * Access your database
    * Download your code

    <Tip>
      If you're stuck mid-project, consider upgrading to a higher tier, or contact [support@getmocha.com](mailto:support@getmocha.com) to discuss options.
    </Tip>
  </Accordion>

  <Accordion title="Can I buy credits without a subscription?">
    We're exploring adding one-time credit packs based on user demand. If this interests you, let us know at [support@getmocha.com](mailto:support@getmocha.com).

    Currently, the best way to get more credits is to subscribe to a paid plan (Bronze, Silver, or Gold).
  </Accordion>

  <Accordion title="When does my billing cycle reset?">
    Your credits reset on the anniversary of when you started your subscription. For example, if you subscribed on the 15th of the month, your credits will refresh on the 15th of each following month.

    You can check your current credit balance and billing date from the main menu in the top left corner of the app.
  </Accordion>
</AccordionGroup>

***

## Scalability FAQ

<AccordionGroup>
  <Accordion title="How many users can my app support?">
    Mocha apps are hosted on Cloudflare's global infrastructure, which is designed to handle significant traffic. Your app can serve many concurrent users without you needing to worry about server management or scaling.

    For most use cases—including small businesses, communities, and growing startups—Mocha's infrastructure handles the load automatically.
  </Accordion>

  <Accordion title="Can I build a SaaS with thousands of users?">
    Yes! Mocha's infrastructure scales automatically. Many users build and run SaaS products, membership sites, and tools with substantial user bases on Mocha.

    For the best experience with larger applications, we recommend Silver or Gold tiers which have generous limits on app size and published apps.
  </Accordion>

  <Accordion title="What happens if my app gets a lot of traffic?">
    Mocha apps run on Cloudflare, which automatically handles traffic spikes. You don't need to configure anything—the infrastructure scales up to meet demand and scales down when traffic subsides.
  </Accordion>

  <Accordion title="What are the storage limits?">
    Storage limits vary by tier. Silver and Gold tiers have very generous limits that accommodate most use cases. If you're building something that requires large amounts of data storage, consider reaching out to [support@getmocha.com](mailto:support@getmocha.com) to discuss your needs.
  </Accordion>
</AccordionGroup>