Skip to content

Latest commit

 

History

History
53 lines (37 loc) · 3.2 KB

publishing.md

File metadata and controls

53 lines (37 loc) · 3.2 KB

Publishing Primo Sites

To publish, you need to either download your site & host it manually, or enter your Github Token to publish to Github - this is the recommended option. Primo will create a new repository under your account or you can deploy to an existing repository.

Once you've deployed to your repository, you can publish your site to any modern web host & auto-deploy it when you publish updates to the repository from Primo.

Connecting to Github

  1. Go to Github settings > Generate new token.
  2. Give your token a name, select an expiration date (ideally 'No expiration') and select the repo permission. Select repo option
  3. Copy + paste the generated token token into Primo & click 'Connect'. Select repo option Select repo option
  4. Once you're connected, you can choose to either deploy to an existing repo or create a new one. Select repo option

Deploying to a web host

The easiest way to get your Primo sites online is to deploy them to a Github repository, then sign up for a modern web host like Vercel, Netlify, or Render to publish your Github repository to the web. When you deploy changes to the repo from Primo, they'll be auto-published to the host without needing to set up additional CI/CD. Below, you can find specific instructions for each host.

Deploying to Vercel

Vercel is the recommended web host since it offers the most straightforward path to get your sites online.

  1. Create a new project
  2. Choose your Primo site's repo as the source
  3. Click 'Deploy'

Vercel

Deploying to Netlify

  1. Under 'Sites', select 'Import from Git'
  2. Click 'Deploy with Github'
  3. Choose your Primo site's repo as the source
  4. Click 'Deploy sitename'

Netlify

Deploying to Render

  1. From the dashboard, click 'New Static Site'
  2. Choose your Primo site's repo as the source
  3. For "Publish Directory", type "./"
  4. Click 'Create Static Site'

Render

Deploying to Github Pages

⚠️ Github Pages isn't recommended as a host due to conflicts with publishing to subdomains (e.g. mateomorris.github.io/blog). All of the hosts listed above also have free personal plans, can be signed into with your Github account, and can be spun up just as quickly.

  1. Ensure your site's deployed repo is named "yourgithubusername.github.io"
  2. After a moment, your site should be published to "yourgithubusername.github.io"

GH Pages