Skip to main content
The Primo CLI (primo-cli) lets you build and edit Primo sites from local files using your own editor and version control. It runs a local CMS server, syncs file changes both directions, and ships your workspace to production.
The CLI is optional. You can still build everything in the in-browser editor — the CLI is for developers who prefer working in files and Git.

Installation

Requirements:

Quick Start

This scaffolds a workspace and starts primo dev on http://my-site.localhost:3000.

Workspace Structure

A Primo workspace contains one or more sites and a shared block library:
Each site is served on its own subdomain in dev: site-one.localhost:3000, site-two.localhost:3000.

Command Summary

When to Use Which Command

Next Steps

Local Development

Run the local CMS and learn the file/CMS sync model

Sync with a Hosted Server

Use primo push and primo pull against a deployed instance

Deploy

Deploy your workspace to Railway, Fly.io, or any static host

MCP Server

Let AI agents work inside your Primo workspace safely