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.
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.
You’re ready when: Your site opens in a local browser preview.
Starts with Node.js and the CLI installed. Use the setup prompt or CLI instructions to install them first.
Read the walkthrough steps
- With Node.js and the CLI installed, create a workspace. This demo skips MCP setup.
- Inside the workspace, create a site. --skip-dev leaves starting the server to you.
- Validate the site files before starting Primo.
- Run primo dev --author files. Open its editor URL: Browse mode keeps local files authoritative.
- 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.
You’re ready when: You can edit content and create a page in the browser, and the site looks right on your phone.
Read the walkthrough steps
- A complete site, ready for your content.
- Click the headline and make it your own.
- Replace a photo directly on the page.
- Create a blog post from a reusable page type.
- The same design, with this post’s own content.
- 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.
You’re ready when: Your client can sign in and make the routine updates you’ve set up for them.