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

# Core concepts

> The mental model behind Fimo — projects, environments, content, media, i18n, scheduled agents, Studio, and hosting.

Your coding agent builds the site. **Fimo owns everything after the build** — and keeps it editable by non-developers and operable by AI. One source of truth, two surfaces: the **`fimo` CLI** for you and your agent, and **Fimo Studio** for your non-technical teammates. Here are the pieces that make that work.

## The building blocks

<AccordionGroup>
  <Accordion title="Project" icon="folder">
    One website, with its own code, content, media, and settings. A project lives inside an organization and is linked to a local directory by `.fimo.settings.json` (written once by `fimo init` — never edit it). It's a real git repo with `fimo` as the remote, so there's no lock-in.
    <br />See [Projects & onboarding](/docs/cli/projects).
  </Accordion>

  <Accordion title="Environment" icon="code-branch">
    A git-shaped, isolated clone of the project: a git branch **plus** its own database, sandbox, preview URL, and assets. Every project starts on `main`; you create more for feature work, preview them per-env, then merge back and publish. CLI commands target the env of your current git branch.
    <br />See [Environments](/docs/environments/overview).
  </Accordion>

  <Accordion title="Content & CMS" icon="database">
    Structured content lives in the CMS, not in code. You declare **schemas** (content models like `BlogPost` or `Product`) and create **entries** against them. Editors change entries in Studio without touching code; your app renders them with generated hooks and `fimo/ui` components.
    <br />See [Content & CMS](/docs/cli/content).
  </Accordion>

  <Accordion title="Media library" icon="image">
    A central library for images, videos, and files — uploaded once and reused across the site. You can also generate images and video with AI. Fimo tracks dimensions, alt text, and captions.
    <br />See [Media & AI generation](/docs/cli/media).
  </Accordion>

  <Accordion title="Labels & i18n" icon="language">
    Static UI copy — headings, buttons, nav, placeholders — is wrapped in `t('key')` in code, and its value lives in the database so editors can reword it. Add locales in `fimo-config.json` to serve the same site in multiple languages.
    <br />See [Labels, locales & i18n](/docs/cli/labels).
  </Accordion>

  <Accordion title="Forms" icon="rectangle-list">
    Contact, signup, and feedback forms are defined as JSON, pushed with the CLI, and rendered from a generated, validated client. Submissions are captured server-side and readable from the terminal or Studio.
    <br />See [Forms](/docs/cli/forms).
  </Accordion>

  <Accordion title="Scheduled agents" icon="robot">
    Agents-as-files that live in your repo and run on a schedule (or on demand) to keep the site alive — SEO audits, content translation, broken-link sweeps, post-deploy checks. They reach the server through `fimo deploy`.
    <br />See [Scheduled agents](/docs/agents/overview).
  </Accordion>

  <Accordion title="Deploy & hosting" icon="cloud-arrow-up">
    Fimo hosts your site. `fimo deploy` gives an on-demand hosted preview; `fimo deploy --publish` goes live from `main`. Every deploy also emits an AI-friendly markdown version of the site. Your default URL is `<slug>.fimo.site`, with custom domains available.
    <br />See [Deploy & publish](/docs/deploy/overview).
  </Accordion>

  <Accordion title="Fimo Studio" icon="table-cells">
    The visual web app your non-technical teammates use — visual editing, the CMS, the media library, version history, SEO, and publishing — over the exact same project the CLI drives.
    <br />See [Fimo Studio](/docs/studio/overview).
  </Accordion>
</AccordionGroup>

## What's next

<Columns cols={3}>
  <Card title="Quickstart" icon="rocket" href="/docs/get-started/quickstart">
    From `fimo init` to a live site.
  </Card>

  <Card title="Build with the CLI" icon="terminal" href="/docs/cli/overview">
    The full `fimo` command surface.
  </Card>

  <Card title="Billing & credits" icon="credit-card" href="/docs/collaboration/billing-and-credits">
    AI credits, environment hours, and bandwidth.
  </Card>
</Columns>