Getting Started
Primo Desktop
With Primo Desktop, you build your sites from your desktop, save them locally, and publish your sites to Netlify/Vercel, or download them. Your sites save as individual JSON files. You can set the directory to which your sites will save.
You can download Primo Desktop for Mac and Windows from primo.so.
Dashboard
The dashboard is where you manage your existing sites and create new ones, as well as set your web host, Primo Server, local save directory & telemetry preferences.
Settings
Hosting - To connect a host, create a personal access token (Vercel & Netlify) and enter it when prompted. Once added, you'll be able to publish new sites and updates directly to your host.
Server - If you've set up a Primo Server, you can manage your sites from Primo Desktop by entering the server's URL (the address in the address bar, e.g. https://my-primo-server.vercel.app) and API Token (which you can create from your server's settings). Ensure there isn't a trailing slash (/) after your server's address.
Create an API Token from Primo Server
Enter primo server URL and paste the token into the respective fields
Advanced
- Local Save Directory - You can set where your primo sites are saved to organize your sites into separate folders or place them somewhere more accessible (in order to duplicate or share them easily).
Primo Server
Primo Server lets you self-host Primo on your own server to enable features that aren't possible when using Primo from your desktop.
- Access from any browser (including mobile devices)
- Invite collaborators
- Upload images
You can follow the instructions to install and use Primo Server from Primo's Github Repo.
Dashboard
With Primo Server, you manage your sites from the browser (or Primo Desktop) and publish your sites to Netlify/Vercel (or download them). Your sites save as individual JSON files in your Supabase account's bucket storage.
Invite Collaborators to the Server
From the dashboard go to "Invite collaborators". Primo generates a secret invitation link that you can send to anyone to have them have full access to your server (besides changing users' roles). You can make somebody an admin once they've joined your server.
Use the dropdown to make the invitation for a Developer role or a Content Editor role. Then copy the single-use link and share it with the collaborator.
When the collaborator opens the link they will be prompted to create a username and password to access the server.
Invite Collaborators to a single site
To invite collaborators to edit a single site, click "invite" on the site card
Choose whether you want to invite a collaborator as a developer or as a content editor and then create a link to share with the collaborator. Anyone who has access to the link will be able to publish changes to the site.
Copy the link and share it with a collaborator. The link will lead the collaborator to a login screen where they will create a username/password to access the site.
Settings
Hosting - To connect a host, create a personal access token (Vercel & Netlify) and enter it when prompted. Once added, you'll be able to publish new sites and updates directly to your host. Note that your token lives as plain text in your Supabase instance, but since publishing happens server-side the token never gets downloaded to the client so it's only viewable by you (assuming you're the only one with access to your Supabase account).
Server - Primo generates a secret token which you can enter into Primo Desktop (Dashboard > Settings > Server) to access your server sites from your desktop. You can create a new token at any time, but note that it will make previously generated tokens invalid.