Overview
This article introduces Jekyll + Decap CMS with Netlify Identity, which is a combination of technologies used for creating and managing websites. It explains how to deploy the CMS using Netlify, set up user authentication, and start editing content.
Features
- Jekyll Starter Site: The article provides a basic Jekyll starter site that can be easily deployed.
- Decap CMS Integration: The CMS is integrated into the Jekyll site, allowing for easy content management.
- Netlify Identity Authentication: Netlify Identity is used for user authentication, providing secure access to the CMS.
Installation
To install the theme, follow these steps:
- Click on the “Deploy to Netlify” button to create your own repository.
- After the deployment is complete, a new repository will be created in your GitHub account.
- You will receive an email invitation to become an Identity (authentication) user. Accept the invitation and set your new password.
- Navigate to /admin on your site to log in and start editing content.
Note: If you switch the repository from public to private, you will need to regenerate your token. To do this, go to the “Settings” section in the Netlify site dashboard, click on “Identity”, and then click on “Edit settings”. From there, you can generate a new access token in GitHub.
To preview the site and log into the CMS locally, clone the repository and run the following command:
npm run start
You can then access the site at localhost:4000 and the CMS at localhost:4000/admin.
Alternatively, you can authenticate without Netlify Identity using basic OAuth. To do this, register a new application on the GitHub developer application screen. Then, in the Netlify site dashboard, go to the “Access” tab and enter the Client ID and Client Secret in the GitHub Authentication Provider section. This will allow anyone with write access to your GitHub repository to log in and use the CMS.
Summary
The article introduces Jekyll + Decap CMS with Netlify Identity, providing a guide on how to deploy the CMS, set up user authentication, and start editing content. It also provides an alternative method of authentication using basic OAuth with GitHub. Overall, this combination of technologies offers a powerful solution for managing website content.