Decap CMS

What Is Decap CMS?

Decap CMS (formerly Netlify CMS) is an open-source, Git-based headless CMS. Content is stored directly in your Git repository as Markdown or YAML files, and editors manage content through a web-based admin interface .

Decap adds a route (typically /admin) to your Astro project. Authorized users log in, write content, and changes are committed directly to your source repository .

---

How It Works with Astro Docus

Decap CMS integrates with Astro through a React-based admin dashboard served from your deployed site. The CMS reads and writes content files in your Git repository, then Astro builds the final site from those files .

Integration Options

There are two ways to add Decap to Astro Docus:

1. Static Admin Folder

Create a public/admin/ folder containing:

• index.html — entry point that loads the Decap CMS script
• config.yml — CMS configuration defining backend, collections, and fields

2. Astro Integration Package

Install an integration package like @jee-r/astro-decap-cms or astro-decap-cms that handles the admin route, Netlify Identity Widget injection, and local dev proxy automatically .

The integration adds:

• The Decap CMS dashboard at /admin (configurable)
• Netlify Identity Widget for authentication
• A local proxy server for development mode

---

Content Collections Integration

Decap CMS works well with Astro’s Content Collections system. You configure each collection in config.yml to match your Astro schema, and Decap provides a visual editor for each frontmatter field .

This maps directly to Astro’s content collection schema, so editors can manage blog posts without touching code .

---

Authentication

Decap CMS requires an authentication backend. Two common options:

Netlify Identity

When deploying to Netlify, enable Identity in the Netlify dashboard. The Netlify Identity Widget handles login on the admin route .

External OAuth

When deploying to other providers, you must create your own OAuth routes. In Astro, this requires on-demand rendered routes with an adapter enabled .

Some integrations (like astro-decap) provide built-in GitHub OAuth endpoints so you can use Decap without Netlify Identity .

---

Setup Requirements

Setting up Decap CMS involves:

1. Creating the admin route (/admin)
2. Writing config.yml with backend and collection definitions
3. Configuring authentication (Netlify Identity or OAuth)
4. Matching collection schemas to Astro content collections
5. Configuring media storage (media_folder and public_folder)

This is a configuration-heavy setup that varies depending on your deployment target and content structure.

---

Is Decap CMS Right for Astro Docus?

Decap CMS is a good fit if you:

• Want Git-based content management without a separate database
• Need a free, open-source CMS
• Are deploying to Netlify (simplest authentication path)
• Have content that maps cleanly to Astro collections

It may not be ideal if you:

• Need visual editing with live previews (consider Tina Cloud)
• Want zero configuration (Decap requires manual setup)
• Are deploying to non-Netlify hosts without OAuth infrastructure

---

Important Note

Decap CMS integration is a service, not a built-in feature of Astro Docus. The template ships with the content structure ready for CMS integration, but the setup requires configuration specific to your repository, hosting, and authentication method.

If you need help setting up Decap CMS for your Astro Docus site — including authentication, collection configuration, and content migration — professional setup services are available.

👉 Contact for Decap CMS integration assistance: https://www.fiverr.com/creativitas/convert-your-figma-and-ui-design-to-flatfile-cms-or-ssg