Skip to main content
Fimo hosts your site. fimo deploy is on-demand — not your working loop and not a required final step. The loop is local (pnpm dev); reach for deploy only when you want a hosted preview, a shareable link, or to go live, and batch related edits into one deploy.

​
The commands

  • fimo deploy commits pending changes, pushes to the current environment’s branch, syncs its preview sandbox, and prints the preview URL. It’s env-aware — it targets the environment of your current git branch.
  • fimo deploy --publish does the same, then triggers a live publish and prints the live URL. Runs from main only. Use --publish only on a “ship it” / “go live” signal.
  • -m is the commit message for uncommitted changes — required in non-interactive shells.
  • --no-restart lets Vite HMR pick up the change instead of restarting the sandbox dev server. Safe for src/**, assets, and content JSON; not for vite.config.*, package.json/lockfiles, .env, or .fimo/. When in doubt, omit it.

​
When to run which

fimo deploy

Show a hosted version in Studio, share a link, or smoke-test a change on the deployed sandbox.

fimo deploy --publish

Go live — first-time completion, or an explicit publish request. For a tagged release, use fimo publish --version instead.
Just need the current preview URL without pushing code? That’s fimo preview url — sub-second, no commit or push. Don’t run fimo deploy just to refresh a link.
Projects with Disable Preview turned on still accept fimo deploy, but they sync changes without starting a visual Preview environment or returning a Preview URL. fimo preview url explains that Preview is disabled. Turn the setting off in Project Settings to use Preview again.

​
Markdown for AI agents

Every deploy emits an AI-friendly version of the site alongside the HTML — no setup needed.
  • A .md next to every prerendered page (e.g. index.html → index.md), with frontmatter from <title> / meta / OG tags and the <main> content as GitHub-flavored markdown.
  • A /llms.txt at the site root — a markdown index of all pages, following the llms.txt convention.
Agents can fetch it three equivalent ways:

​
What’s next

Custom domains

Put your site on your own URL.

Analytics

Traffic for your published site.

Preview vs production

Preview and production, compared.