> ## 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.

# FAQ

> Frequently asked questions about Mocha

<Warning>
  **Mocha is shutting down on August 1, 2026.** Read the [shutdown announcement](https://getmocha.com/blog/mocha-shutdown) to learn how to migrate or export your apps.
</Warning>

<AccordionGroup>
  <Accordion title="What is Mocha?">
    Mocha is an AI-powered platform that enables users of any skill level to create full-stack web applications without requiring coding expertise by simply describing what they want in plain English. Instead of hiring developers, users can generate web apps or websites instantly.
  </Accordion>

  <Accordion title="Is Mocha free?">
    Mocha offers a freemium model with different tiers to suit your needs. You can get started for free and upgrade to a Pro plan when you need more features and resources. Learn more about our [subscription plans](/billing/account-subscriptions).
  </Accordion>

  <Accordion title="How do I sign up and get started?">
    Simply create an account on Mocha, explore the interface, and start building by typing prompts that describe what you want to create.
  </Accordion>

  <Accordion title="What can I build with Mocha?">
    You can build any web app idea that you have. A website for your business, a SaaS, landing pages, AI-powered utilities, internal tools,... Your ideas are the limit.
  </Accordion>

  <Accordion title="Does Mocha support backend?">
    Yes, Mocha is a full-stack app builder and comes batteries included with a database, API server, and optionally authentication. You can also call any backend APIs by passing your own secret API keys to the system.
  </Accordion>

  <Accordion title="What technologies are Mocha apps built on?">
    Mocha chooses the tech stack for you. It uses TypeScript, React, Hono (for API endpoints), and a SQLite database. We use Cloudflare for hosting Mocha apps. This is designed to be reliable and performant for the vast majority of app-builder use cases.
  </Accordion>

  <Accordion title="Can I bring my own tech stack or publish to external platforms?">
    No. Mocha is designed to be accessible by people with no technical background, so we make choices on behalf of Mocha users.

    Supporting arbitrary tech stacks or external platforms would introduce complexity and lead to a less reliable product, particularly for non-techincal users.
  </Accordion>

  <Accordion title="Do I need coding experience to build an app?">
    No! Mocha is designed for people with 0 coding experience and expertise. Our goal is to empower people who previously couldn't build their own apps. We offer some internal tools like the code editor in case you're technical and want to get your hands dirty, but these are completely optional.

    Mocha allows non-technical users to create apps through a structured workflow: **plan, prompt, scaffold, debug, and deploy.** You can generate project documentation, break the process into steps, and let AI guide you.
  </Accordion>

  <Accordion title="Can I learn coding with Mocha?">
    Yes! It is completely optional but Mocha gives you access to the code and you can use [Discuss Mode](/basics/discuss-mode) to ask questions and get help.

    The best way to learn is by doing. Mocha helps you understand coding by:

    * Generating and explaining code
    * Encouraging pattern recognition in AI-generated responses
    * Allowing experimentation and debugging
  </Accordion>

  <Accordion title="How long does it take to build a full-stack app?">
    It depends on complexity. By breaking tasks into smaller steps, planning ahead, and refining based on feedback, you can move quickly while ensuring quality.

    In a matter of minutes, you can get a landing page up and running.

    For more serious projects, you can expect to spend 1-2 hours to get a solid version running.
  </Accordion>

  <Accordion title="What should I do if I encounter an issue with Mocha?">
    Mocha provides an AI-driven debugging tool that analyzes errors in real time. If an error occurs:

    * Click "Fix with AI"
    * Use [**Discuss Mode**](/basics/discuss-mode) to describe the issue and ask Mocha to debug it
    * Review error logs and console output for additional details

    Try refreshing your session or reviewing documentation. If the issue persists, contact **Mocha Support** through our support page.
  </Accordion>

  <Accordion title="What's the best way to structure a project in Mocha?">
    We have built Mocha to be very opinionated. We're website building experts and make the AI structure things for you.
    You should focus on the **idea** and the outcomes you want. If you describe what you want clearly, Mocha will structure the project for you.

    You can also use [Discuss Mode](/basics/discuss-mode) to plan the next feature and have Mocha write a clear PRD (product requirements document) for you. Then switch back to edit mode and say "Build it!" and Mocha will comply.
  </Accordion>

  <Accordion title="Can I use my own domain with Mocha?">
    Yes! You can use your own custom domain with Mocha. We support connecting domains from any registrar, and you can even purchase domains directly through Mocha with our IONOS integration. Learn more about [custom domains](/basics/custom-domains).
  </Accordion>

  <Accordion title="Can I download the code from my project?">
    Yes! You can download your project code at any time. Click the app name in the header, and you'll see a download code button. Learn more about [downloading your project](/basics/hosting#can-i-download-my-project%3F).
  </Accordion>

  <Accordion title="Can I send diagrams or screenshots?">
    Yes! Diagrams (from Miro/FigJam/etc.) and screenshots are super helpful—especially for flows and UI bugs. While videos aren't supported yet, screenshots can often do the job. Learn more about [using images](/basics/assets).
  </Accordion>

  <Accordion title="I just hit an app size limit error, what do I do?">
    Mocha has the concept of an "app size". The more complex your app is, the bigger the app size. Each tier has different limits for the app size. In practice, silver tier and above have incredibly high app size limits, and you should never hit them unless you're building a terribly complex app.
  </Accordion>

  <Accordion title="What are credits?">
    Credits are an internal mechanism Mocha uses to track usage. When you ask Mocha to do something, it uses an amount of credits proportional to the complexity of the request. Simple tasks take only a few credits, and larger tasks can take north of 100 credits (this is rare, most changes should take between 15 and 50 credits).

    You can see your remaining credits in the top left menu of the app.

    You can get more credits by upgrading to a Pro plan. Each tier refreshes your credits every month.

    Subscription credits refresh each month and can accumulate up to **2× your monthly subscription allowance** (base plan + bundles). If you're already at the cap at renewal, you won't receive additional subscription credits until you spend some. Purchased and gifted credits never expire and are only used after subscription credits run out.

    Learn more about credits in our [limits guide](/billing/limits).
  </Accordion>

  <Accordion title="Can I import designs from Figma?">
    Mocha doesn't have a direct Figma import feature. However, you can:

    * **Take screenshots** of your Figma designs and share them with Mocha—describe what you want and the AI will recreate it
    * **Describe your design** in detail and let Mocha generate it
    * **Use reference images** to guide the AI toward your desired look

    Screenshots and reference images are often very effective at communicating design intent to the AI.
  </Accordion>

  <Accordion title="Is there a visual drag-and-drop builder?">
    Mocha is primarily **AI-driven** rather than drag-and-drop. Instead of manually placing elements, you describe what you want and Mocha builds it for you.

    That said, we do offer [Direct Edit Mode](/basics/direct-edit) which lets you click on text and edit it directly—perfect for quick content changes without using credits.

    We're also working on more visual editing features for the future.
  </Accordion>

  <Accordion title="Can I see and edit the code directly?">
    Yes! While Mocha is designed for non-technical users, you can absolutely view and edit the code if you want to:

    1. Click the code toggle in the top left to enter dev mode
    2. Browse and edit files directly
    3. Changes save automatically and the preview updates in real-time

    This is completely optional—you don't need to touch code to build with Mocha.
  </Accordion>

  <Accordion title="What happens if Mocha doesn't understand my request?">
    If Mocha misunderstands or creates something different than what you wanted:

    1. **Be more specific** - Add details about what you want
    2. **Use screenshots** - Show Mocha what you're looking for
    3. **Use [Discuss Mode](/basics/discuss-mode)** - Chat about your idea first before making changes
    4. **Restore a previous version** - Roll back and try a different approach

    Breaking complex requests into smaller, specific steps often works better than asking for everything at once.
  </Accordion>

  <Accordion title="Can I choose my model in Mocha?">
    You can't choose your model directly, but Mocha offers two modes: **Max Mode** and **Default Mode**. Both are available on all tiers, including Default. Choose [Max Mode](/basics/max-mode) if you want the best results and aren't cost-sensitive.
  </Accordion>

  <Accordion title="How do I get the best results from Mocha?">
    Tips for getting great results:

    * **Start with a clear plan** - Know what you want before you start prompting
    * **Be specific** - "Add a blue button that says Contact Us in the header" works better than "make it look better"
    * **Use screenshots** - Visual references help the AI understand what you want
    * **Build incrementally** - Small, focused changes are more reliable than big, complex ones
    * **Use Discuss Mode** - Plan complex features before building them
    * **Use [Max Mode](/basics/max-mode)** - For complex tasks, Max Mode delivers the best results

    Check out our [prompting guide](/guides/prompting) for more tips.
  </Accordion>
</AccordionGroup>