Strapi plugin logo for Site Publisher

Site Publisher

Publish your site using GitHub Actions

thumbnail for Site Publisher

Strapi v4 - Site Publisher Plugin

This is a plugin for Strapi headless CMS. It lets you trigger a GitHub Action workflow when the site is ready to be published.

NPM version Actions Status PR Welcome

Introduction

Screenshot

When using Strapi as a headless CMS for a statically built website, you need a way to trigger the site to rebuild when content has been updated. The typical approach is to setup a Strapi managed webhook to trigger a CI/CD pipeline whenever content changes. This approach has it's issues. For example when making many changes to content, builds are triggered multiple times and deployments can fail due to the site being deployed concurrently.

This plugin tackles the publishing flow a different way. The site administrators can take their time and make many changes and once the content update is complete they can trigger a single build.

This plugin also checks to see if a build is already in progress and not allow the user to trigger another. Also, when a build has been triggered the user can wait on the plugin page to see when the build and deployment has completed.

Installation

Install this plugin with yarn:

yarn add strapi-plugin-site-publisher

Configuration

Generate a config file at config/plugins.js or config/development/plugins.js, etc...

1module.exports = ({ env }) => ({
2  'site-publisher': {
3    config: {
4      owner: 'username', // The Github organisation or user
5      repo: 'reponame', // The name of the repository
6      workflow_id: 'rebuild.yml', // The workflow_id or filename
7      token: env('GITHUB_TOKEN'), // The GitHub personal access token with access to trigger workflows and view build status
8      branch: 'master', // The branch the workflow should be triggered on
9      inputs: {
10        // Optional inputs to pass through to the GitHub workflow
11        some_input: 'Some value',
12        some_other_input: 'Some other value',
13      }
14    }
15  }
16});

Make sure you have variable in your .env file

GITHUB_TOKEN=XXXXXXX

Use the Plugin

When the plugin has been installed correctly just click on "Publish Site" in the sidebar under plugins then click "Publish".

Roadmap

  • Error handling
  • Support other deployment platforms (Gitlab CI, Bitbucket, Netlify, etc)
  • Configure the plugin from admin panel

Credits

This plugin is a fork of strapi-plugin-github-publish by Phantom Studios, many thanks to them for their work.

Install now

npm install strapi-plugin-site-publisher

STATS

6 GitHub stars40 weekly downloads

Last updated

285 days ago

Strapi Version

4.0.0 and above

Author

github profile image for Valentin Day
Valentin Day

Useful links

Create your own plugin

Check out the available plugin resources that will help you to develop your plugin or provider and get it listed on the marketplace.