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
- Node.js 18+
- For
primo deploy: Railway CLI or Fly.io CLI
Quick Start
primo dev on http://my-site.localhost:3000.
Workspace Structure
A Primo workspace contains one or more sites and a shared block library: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 instanceDeploy
Deploy your workspace to Railway, Fly.io, or any static host
MCP Server
Let AI agents work inside your Primo workspace safely