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.

Hosting Screenshot

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

Screenshot

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).

Screenshot


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.

Screenshot

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

Screenshot

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.