primocms / primo

Primo is a visual CMS with a built-in code editor, Svelte blocks, and static site generator.
https://primocms.org
MIT License
2.06k stars 543 forks source link
cms component-library css html ide jamstack primo static-site static-site-generator svelte wordpress

Primo Primo

The modern monolithic CMS

Primo makes it a blast to build pages, update content, and edit code - one block at a time.

Primocms.orgDiscordDocsNewsletterYouTube

screenshot

⭐ Why Primo?

Traditional monolithic CMSs like WordPress, Drupal, and Joomla enable quick setup and easy content editing, but rely on antiquated and heavy development practices (often relying on plugins and third-party services to customize the site and add new components). Headless CMSs have popped up to modernize the view layer with modern development practices and frameworks, but have a poorer content editing experience due to their decoupling from the content layer.

Primo is a modern approach to the monolithic CMS that builds on the traditional monolith's benefits of a quick setup and easy content editing alongside the benefits of modern development (i.e. Svelte). These combine into a web publishing tool that is significantly easier and more fun to use for both technical and non-technical users and enables you to build faster, more secure, and more unique websites.

✨ Features

Read more in the Docs

How to self-host Primo

Primo depends on several [freemium] third-party services for easy hosting, authentication, database and storage, etc. Running your own Primo server is as easy as forking the Primo repo and deploying it on a static host like Vercel or Netlify, which should only take a few minutes.

Third-party services (all can be signed into with Github):

Installation

  1. Ensure you have an account with all the services listed above.

  2. Create a new Supabase project, go to the SQL editor, add a new query and provision your project by copying the schema and pasting it into the editor.

  3. Fork the Primo repository.

  4. Go to your web host and create a new project from your new repository, inputting your Supabase details (go to the API settings) as environment variables.

    • PUBLIC_SUPABASE_URL

    • PUBLIC_SUPABASE_PUBLIC_KEY

    • PRIVATE_SUPABASE_PRIVATE_KEY

Environment Variables

  1. Publish the project and navigate to the Primo authentication screen.

  2. The user account you create will be the server owner. You can manage all your server's data from the Supabase project dashboard.

  3. Finally, go back to your Supabase project & set the Site URL to the URL of your Primo site (under Authentication > URL Configuration > Site URL).

    Screenshot 2023-07-11 at 12 44 26 PM

For more details see this step-by-step installation video guide

Updating

You can merge upstream updates by clicking 'Sync fork' on your forked repository. Your updates will automatically deploy to your web host.