Skip to content
Archipelago Docs

Editing with Decap CMS

Decap CMS provides the /admin/ editor for people who should not need to clone the repository locally.

Self-hosted phase

Section titled “Self-hosted phase”

For a self-hosted static site, Decap still needs an authentication bridge to GitHub.

Common choices:

  • run a small Decap/Netlify CMS OAuth provider yourself
  • use a hosted OAuth provider
  • temporarily edit through GitHub PRs until Netlify is chosen

The current public/admin/config.yml contains placeholders for the GitHub repository owner and OAuth base URL.

Future Netlify phase

Section titled “Future Netlify phase”

If the site moves to Netlify later, Decap CMS becomes simpler:

  • use Netlify Identity + Git Gateway, or
  • keep the GitHub backend and configure OAuth there

The content remains Markdown, so the hosting path can change without moving the knowledge base into a database. Good. The old records remain readable.