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

# Migrate to Fimo

> Move an existing site into Fimo, preserving routes, media, CMS, forms, SEO, redirects, and locales.

Migration brings an existing website into Fimo without silently dropping content. It inventories your source, rebuilds pages with Fimo conventions, and imports your media, content, and forms — so the result is a real Fimo project your team can keep editing.

## How it works

`fimo migrate` prepares an agent-ready migration draft from a published URL. The bare command runs the full pipeline; each stage is also a subcommand you can run on its own:

```bash theme={null}
fimo migrate <url> [dir]     # full pipeline: init → inspect → apply → refine
fimo migrate init <url>      # crawl the site and write migration artifacts
fimo migrate inspect         # summarize the migration manifest
fimo migrate apply           # generate an agent-ready Fimo scaffold
fimo migrate refine          # prepare a high-context handoff for your coding agent
```

The output is a draft and an evidence pack, not the final visual rebuild — your coding agent does the source-faithful rebuild pass from the handoff the CLI writes.

<Note>
  Migration and deployment are separate. Importing content is part of migration; `fimo deploy` / `fimo publish` are a single, final, owner-approved step — never run them just to "check" rendering.
</Note>

## What's preserved

<Columns cols={2}>
  <Card title="Routes & redirects" icon="signs-post">
    Every source route is rebuilt, redirected, or listed as unresolved — nothing disappears silently.
  </Card>

  <Card title="CMS & content" icon="database">
    Collections and entries are modelled as Fimo schemas, with source IDs, slugs, dates, and authors preserved.
  </Card>

  <Card title="Media" icon="images">
    Referenced assets are uploaded into the Fimo media library and rewired from the originals.
  </Card>

  <Card title="Forms" icon="rectangle-list">
    Forms become Fimo-native forms, a third-party plan, or a documented unsupported note.
  </Card>

  <Card title="SEO" icon="magnifying-glass">
    Titles, descriptions, canonical URLs, share images, and metadata carry over when present.
  </Card>

  <Card title="Locales" icon="language">
    Localized routes and content are kept, not collapsed into a single language.
  </Card>
</Columns>

A verifiable **QA gate** confirms coverage before a migration is called complete: source counts must match imported counts, and any gap is recorded as an explicit, owner-visible unresolved item.

## What's next

<Columns cols={3}>
  <Card title="Supported sources" icon="list" href="/docs/migration/platforms">
    Webflow, Framer, Squarespace, Wix, Carrd, and generic exports.
  </Card>

  <Card title="Wrap mode" icon="box" href="/docs/migration/wrap">
    Bring an existing codebase or framework site into Fimo.
  </Card>

  <Card title="Build with the CLI" icon="terminal" href="/docs/cli/overview">
    The schema, entry, media, and form commands migration relies on.
  </Card>
</Columns>