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

# Quick start

> Build and publish your first app with Mythos — sign in, describe what you want, iterate in chat, and ship to a live URL. Takes a few minutes.

This guide takes you from a blank account to a published site, using your free credits — nothing to
pay to follow along.

## Before you start

* A Mythos account (sign in with Google, GitHub, or an email code).
* Your **5 free credits** — granted automatically when you confirm your account. A first build costs
  3, so the free credits cover it.

Two later steps have their own prerequisites: the backend step needs a **Supabase project** to
connect, and exporting the code needs a **one-time GitHub connect**. Neither is required to build and
publish your first site.

## Build your first project

<Steps>
  <Step title="Start from a prompt">
    On your dashboard, type what you want to build in the prompt box. Be specific about the kind of
    site and its sections — Mythos turns vague prompts into real ones, but detail gets you closer on
    the first try.

    ```text theme={null}
    Create a landing page for a moving company called Iron Anchor —
    hero, services, pricing, testimonials, and a quote-request form.
    Dark, industrial look.
    ```
  </Step>

  <Step title="(Optional) Plan it first">
    Toggle **Plan mode** before sending to answer a few questions (services, palette, typography),
    pick from **a few rendered design directions**, and approve a short plan before any code is
    written. See [Plan mode](/features/plan-mode). Planning is free — you only spend credits on the
    build itself.
  </Step>

  <Step title="Watch it build">
    Mythos scaffolds the project and streams a live progress card, then a preview. This first build
    costs **3 credits**. Behind the scenes it's a real commit in the project's private repository.
    Connect your GitHub account once and you can export a clean copy that is yours anytime.
  </Step>

  <Step title="Iterate">
    Refine in chat — each edit costs 2 credits:

    ```text theme={null}
    Make the hero background darker and add a logo placeholder.
    Add an FAQ section with four questions.
    ```

    Or open the **workspace editor** to change the code directly when you want precise control.
  </Step>

  <Step title="Add a backend (optional)">
    To make the quote form actually save submissions, connect **your own Supabase project** under
    Services → Cloud. Mythos then wires the form to a real table in your database. See
    [Connect Supabase](/integrations/supabase).
  </Step>

  <Step title="Publish">
    When you're happy, publish to a live `*.r21.dev` URL. You can add a custom domain later. See
    [Publishing](/publishing/publish).
  </Step>
</Steps>

## While a build runs

Generation is asynchronous, so the chat moves through a few states:

| State     | What you see                                            | What you do                                     |
| --------- | ------------------------------------------------------- | ----------------------------------------------- |
| Building  | A live progress card in the chat                        | Wait — a single page is usually a minute or two |
| Delivered | A result card, and the preview updates                  | Open the preview, then iterate or publish       |
| Refunded  | A short message that something went wrong, credits back | Re-prompt — you were not charged                |

<Warning>Publishing makes your site **public on the internet** — anyone with the URL can open it.
Review what's on the page (and that no private keys are in the frontend) before you publish.</Warning>

## Tips for a good first build

<Tip>Name the sections you want ("hero, services, pricing, FAQ, footer") and the tone ("clean and
minimal" / "dark and bold"). Mythos writes real copy for your industry — mentioning the industry
helps.</Tip>

* Describe **one page** well rather than asking for a whole multi-page site up front — you can add
  pages by chat afterward.
* If you need a form to store data, say so — then connect Supabase so it has somewhere to save.

## Limitations to know up front

* Mythos builds the **frontend**. A database, auth, and file storage come from **your** connected
  Supabase project, not from Mythos.
* A build that runs out of room or errors is **refunded** — you're only charged when a result is
  delivered.

## FAQ

<AccordionGroup>
  <Accordion title="How long does a build take?">Usually a minute or two for a single page. Plan mode's design step takes a little longer because it renders a few options for you to choose from.</Accordion>
  <Accordion title="Do I need to know how to code?">No. You can build and iterate entirely in chat. The code editor is there when you want it.</Accordion>
  <Accordion title="Where does my project live?">Mythos builds it in a private repository and keeps that internal copy. Connect your GitHub account once and you can export a clean, separate repository that is yours — one per project.</Accordion>
  <Accordion title="Can I undo a change?">Yes. Reverting restores an earlier version as a new commit, so your history is never destroyed.</Accordion>
</AccordionGroup>

## Related

* [Signing in](/introduction/sign-in) — get an account and your free credits first.
* [Dashboard & workspace tour](/introduction/dashboard-overview) — where the prompt box, tray, and workspace live.
* [Plan mode](/features/plan-mode) — questions → three designs → plan → build.
* [Writing good prompts](/prompting/writing-good-prompts) — get more from each build.
* [Credits & pricing](/introduction/credits-and-usage) — what each action costs.