Get started

Build your first Primo site.

Paste the setup prompt into your coding agent to build your first site.

01 · Create a site

Get a site running.

Tell your agent what you’re building and create a blank site together.

Read the prompt

Help me create my first Primo site. Read https://docs.primo.build/getting-started/quickstart and check the installed CLI help. Ask what kind of site I need and help me create a blank site. Check Node.js, install the Primo CLI if needed, then initialize a new workspace with primo init before creating a site. Offer to connect the Primo MCP tools to my agent. Start the local server in file authoring mode and show me the working preview and editor URLs.

Paste into your coding agent.

Your agent edits the files first, so the local browser editor starts in read-only mode. When you’re ready to edit in the browser, ask your agent to switch editing modes.

Stuck? Get setup help

You’re ready when: Your site opens in a local browser preview.

Terminal → Local editor
35 secCreate a workspace and a site, start Primo locally, then switch to browser editing.

Starts with Node.js and the CLI installed. Use the setup prompt or CLI instructions to install them first.

Read the walkthrough steps
  1. With Node.js and the CLI installed, create a workspace. This demo skips MCP setup.
  2. Inside the workspace, create a site. --skip-dev leaves starting the server to you.
  3. Validate the site files before starting Primo.
  4. Run primo dev --author files. Open its editor URL: Browse mode keeps local files authoritative.
  5. Stop with Ctrl+C, then run primo dev --author cms to edit in the browser.

02 · Make it yours

Make it yours.

Work with your agent on the design, content, and controls your client will use.

Ask your agent to switch to browser editing mode to try the editor. Switch back before requesting more file changes.

Read the prompt

Help me customize this Primo site. Read the workspace AGENTS.md and use the Primo MCP docs if available. Ask about the design and content, update the source in file authoring mode, and check desktop and mobile layouts. Create the page types and editable fields my client needs, and validate the changes. When I’m ready to try the visual editor, stop only this workspace’s dev server and restart it with primo dev --author cms. Open the editor URL printed in the terminal. Explain how to switch back to file authoring before making more source edits.

Continue in the same agent conversation.

You’re ready when: You can edit content and create a page in the browser, and the site looks right on your phone.

Primo · Edit content
33 secEdit text, replace a photo, create a page, and rearrange blocks.
Read the walkthrough steps
  1. A complete site, ready for your content.
  2. Click the headline and make it your own.
  3. Replace a photo directly on the page.
  4. Create a blog post from a reusable page type.
  5. The same design, with this post’s own content.
  6. Arrange the homepage with reusable blocks.

03 · Put it online

Put it online.

Choose hosted Primo or run your own server. One server can host all your client sites.

Only need a static website? See the export guide

You’re ready when: Your public site opens at its own address, and you can sign in to its browser editor.

04 · Invite your client

Invite your client.

Show your client how to edit and publish. Ask your agent for a short guide with their editor and site links.

Read the prompt

Help me prepare this Primo site for my client. Review the page types and editing fields, and show me how to invite them with the appropriate access. Write a short guide for editing content, creating pages, and publishing, using this site’s actual editor and public URLs. Let me approve any invitation or access changes before they are sent.

Finish the handoff with your agent.

You’re ready when: Your client can sign in and make the routine updates you’ve set up for them.