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

# Quickstart

> Go from fimo init to a live site — install, build with your agent, preview, and publish.

Your coding agent builds the site; Fimo owns everything after. This is the shortest path from nothing to a published Fimo site. If your agent is already driving, point it at [Get started for AI coding agents](/docs/get-started/ai-coding-agents) instead — this page is the human-readable version of the same happy path.

<Steps>
  <Step title="Install the CLI and sign in">
    The `fimo` CLI is published on npm. Run it with `npx` — always the latest, no global install.

    ```bash theme={null}
    npx fimo@latest --version
    npx fimo@latest login
    ```

    `fimo login` opens a browser loopback flow and captures the token automatically — nothing to copy or paste. `fimo whoami` shows the active user and organization; switch orgs with `fimo orgs switch`.
  </Step>

  <Step title="Set up the project">
    **Link an existing project** (you have a project ID):

    ```bash theme={null}
    npx fimo@latest init --project-id <projectId>
    ```

    **Or create a brand-new project** in an empty directory and follow the prompts:

    ```bash theme={null}
    npx fimo@latest init
    ```

    `fimo init` is the single onboarding entry point — it signs you in if needed, creates or links the project, clones it locally, installs dependencies, and offers to set up skills and rule files for your AI tool. Pass `-y` to run non-interactively.

    <Tip>Give the project a human-readable name right after: `fimo rename "Acme Coffee"`.</Tip>
  </Step>

  <Step title="Build against a local dev server">
    Your iteration loop is local. Start the dev server with the project's package manager (match the lockfile), then work with your agent — edit, see the change live, repeat.

    ```bash theme={null}
    pnpm dev     # or npm run dev / yarn dev / bun dev
    ```

    You do **not** need to deploy to see local changes. Your agent uses schemas, entries, forms, `t()` labels, and media through the `fimo` CLI and the project skill.
  </Step>

  <Step title="Deploy a hosted preview">
    When a unit of work looks done, deploy an on-demand preview to get a shareable, hosted link:

    ```bash theme={null}
    npx fimo@latest deploy -m "feat: homepage"
    ```

    This commits pending changes, pushes, syncs the preview sandbox, and prints a preview URL. Just need the current URL again? Use `fimo preview url` — no redeploy.
  </Step>

  <Step title="Publish to production">
    When you're ready to go live, publish from `main`:

    ```bash theme={null}
    npx fimo@latest deploy --publish
    ```

    Your site is served at `<slug>.fimo.site` by default. Rename it or attach a custom domain from the [Custom domains](/docs/deploy/custom-domains) page.
  </Step>
</Steps>

## What's next

<Columns cols={3}>
  <Card title="Core concepts" icon="lightbulb" href="/docs/get-started/concepts">
    The mental model behind projects, environments, content, and agents.
  </Card>

  <Card title="Build with the CLI" icon="terminal" href="/docs/cli/overview">
    Schemas, entries, forms, media, and labels through `fimo`.
  </Card>

  <Card title="Deploy & publish" icon="cloud-arrow-up" href="/docs/deploy/overview">
    Previews, publishing, and markdown for AI agents.
  </Card>
</Columns>