Skip to main content
This is the human path to a first live Fimo site. Starting with an existing codebase or setting up a teammate? Choose your path first.
A new Fimo account opens with a guided Welcome project in Studio. Use it to explore editable content, Preview, Branches, and agents, or follow this quickstart to connect your own code. To keep working on the Welcome project from your own machine, see Work on your project locally.
1

Run the CLI

You do not need a global install. Check the current CLI, then sign in through your browser:
2

Create a project

New projects use the Next.js App Router template by default:
Follow the prompts to choose an organization, install dependencies, and connect your coding agent. To use the canonical React Router template instead, pass --framework react-router.
3

Open the site locally

Move into the project and run its dev script with the package manager selected during setup. fimo init prints the matching command when it finishes. Keep this local server running while you and your coding agent work.
Open the local URL printed by the command. To make the first page editable in Studio, ask your coding agent to load fimo-code and follow First editable site.
4

Create a hosted Preview

When the site is ready for review, deploy it to Preview:
Fimo commits pending changes, pushes them, updates the Preview environment, and returns links to Preview and Studio. Preview is for review. It does not make the site public.
5

Publish deliberately

Review the hosted Preview first. When you want the configured Production source revision to go live, publish it explicitly. New projects use main:
Publishing is separate from Preview so a deploy does not make your work public by accident. See Deploy and publish for the full workflow.

What’s next

Choose another path

Open an existing Fimo project or migrate an existing site.

Learn the concepts

Understand projects, Branches, content, Preview, and production.

Build with the CLI

Work with content, forms, media, and labels.