https://github.com/nuzulul/jekyll-decap-cms-github-pages
Jekyll + Decap CMS hosted on Github Pages
https://github.com/nuzulul/jekyll-decap-cms-github-pages
decap-cms
Last synced: 17 days ago
JSON representation
Jekyll + Decap CMS hosted on Github Pages
- Host: GitHub
- URL: https://github.com/nuzulul/jekyll-decap-cms-github-pages
- Owner: nuzulul
- License: mit
- Created: 2025-04-19T11:39:01.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2025-04-20T05:54:47.000Z (about 1 month ago)
- Last Synced: 2025-04-28T05:02:07.566Z (25 days ago)
- Topics: decap-cms
- Language: HTML
- Homepage: https://nuzulul.github.io/jekyll-decap-cms-github-pages/admin
- Size: 5.86 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-decap-cms - jekyll-decap-cms-github-pages - Jekyll + Decap CMS hosted on Github Pages. (Self Hosted)
README
# jekyll-decap-cms-github-pages
Jekyll + Decap CMS hosted on Github Pages
Demo : [https://nuzulul.github.io/jekyll-decap-cms-github-pages/admin](https://nuzulul.github.io/jekyll-decap-cms-github-pages/admin)
## Decap CMS Installation
### 1. Create OAuth application at Github
- Go to [https://github.com/settings/developers](https://github.com/settings/developers)
- Create `New OAuth app`
- Set `Application name` to anything you like
- Set `Homepage URL` to your Github Pages URL
- Set `Authorization callback URL` to `https://api.netlify.com/auth/done`
- Clik `Register application`
- Generate a `Client Secret`
- Copy the `Client ID` and `Client Secret`
### 2. Setup Netlify OAuth Provider
- Create Netlify new dummy site or existing one
- Go to `Site configuration` > `Access & security` > `OAuth`
- Under `Authentication Providers`, select `Install Provider`
- Select `GitHub` and enter the `Client ID` and `Client Secret` from earlier, then save
- Copy the site domain
### 3. Configure Decap CMS
- Update your Decap CMS `config.yml`
```yaml
backend:
name: github # backend to use
repo: nuzulul/jekyll-decap-cms-github-pages # your username and repo
branch: main # branch to use
site_domain: jekyll-decap-cms-github-pages.netlify.app # the netlify site domain above
```
### 4. Publish
Publish your Decap CMS and open it on your browser, now you should see a Login with Github button
## Alternative without Netlify's Service
- [decap-cms-google-apps-script](https://github.com/nuzulul/decap-cms-google-apps-script) - A Decap CMS Github OAuth Client implementation in Google Apps Script acting as the External OAuth Client allowing Decap CMS without using Netlify's service.
- [awesome-decap-cms#oauth-clients](https://github.com/nuzulul/awesome-decap-cms#oauth-clients) - Decap CMS external oauth clients list.