https://github.com/DemoMacro/vuepress-boilerplate-netlify-cms

VuePress boilerplate integrated with Netlify CMS, powered by Demo Macro.
https://github.com/DemoMacro/vuepress-boilerplate-netlify-cms

Last synced: 3 months ago
JSON representation

VuePress boilerplate integrated with Netlify CMS, powered by Demo Macro.

• Host: GitHub
• URL: https://github.com/DemoMacro/vuepress-boilerplate-netlify-cms
• Owner: DemoMacro
• License: mit
• Created: 2018-12-08T12:02:55.000Z (over 5 years ago)
• Default Branch: main
• Last Pushed: 2023-10-28T03:53:12.000Z (8 months ago)
• Last Synced: 2024-01-16T21:56:43.048Z (5 months ago)
• Language: HTML
• Homepage: https://vuepress-boilerplate.netlify.app/
• Size: 985 KB
• Stars: 22
• Watchers: 2
• Forks: 60
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-stars - DemoMacro/vuepress-boilerplate-netlify-cms - VuePress boilerplate integrated with Netlify CMS, powered by Demo Macro. (HTML)

README

        
---

title: README

---

# vuepress-boilerplate-netlify-cms

![Netlify](https://img.shields.io/netlify/271f5a7f-5024-4e8e-96de-4d49584fae2b)

![GitHub](https://img.shields.io/github/license/DemoMacro/vuepress-boilerplate-netlify-cms)

[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](https://www.contributor-covenant.org/version/2/1/code_of_conduct/)

> VuePress boilerplate integrated with Netlify CMS, powered by Demo Macro.

[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](https://app.netlify.com/start/deploy?repository=https://github.com/DemoMacro/vuepress-boilerplate-netlify-cms&stack=cms)

## Manual start

### [Fork](https://github.com/DemoMacro/vuepress-boilerplate-netlify-cms/fork) on Github

More info: [VuePress Documentation](https://vuepress.vuejs.org/)

### Deploy to Netlify

More info: [Framework integrations](https://docs.netlify.com/integrations/frameworks/#vuepress)

### Enable Identity and Git Gateway

Netlify's Identity and Git Gateway services allow you to manage CMS admin users for your site without requiring them to have an account with your Git host or commit access on your repo. From your site dashboard on Netlify:

1. Go to **Settings > Identity**, and select **Enable Identity service**.

2. Under **Registration preferences**, select **Open** or **Invite only**. In most cases, you want only invited users to access your CMS, but if you're just experimenting, you can leave it open for convenience.

3. If you'd like to allow one-click login with services like Google and GitHub, check the boxes next to the services you'd like to use, under **External providers**.

4. Scroll down to **Services > Git Gateway**, and click **Enable Git Gateway**. This authenticates with your Git host and generates an API access token. In this case, we're leaving the **Roles** field blank, which means any logged in user may access the CMS.

More info: [Git Gateway](https://docs.netlify.com/visitor-access/git-gateway/)

### Add the Netlify Identity Widget

You will need to add it to the `` of your CMS index page at /admin/index.html and to the `` of the main index page of your website. We can use Netlify's script injection feature to include this script in your website.

```html

```

Using Netlify's script injection feature, add the following script to the main index page of your website before the close body tag.

```html

  if (window.netlifyIdentity) {

    window.netlifyIdentity.on("init", (user) => {

      if (!user) {

        window.netlifyIdentity.on("login", () => {

          document.location.href = "/admin/";

        });

      }

    });

  }

```

### Congratulations

You can now manage the content of your website at https://yoursite.netlify.com/admin/.

## License

[MIT](LICENSE) © [Demo Macro](https://github.com/DemoMacro)