CMS Editing Workflows

Compass stores docs as MDX by default, but that does not mean every editor has to work directly in the repository.

When a CMS helps

A CMS-backed workflow is useful when:

• non-developers need to edit regularly
• you want drafts, approvals, or editorial roles
• your team prefers a richer editing UI than plain MDX

Integration ideas

Teams often pair Compass with:

• Sanity for structured content and editorial workflows
• Contentful for managed content models and team permissions
• Storyblok for visual editing
• TinaCMS or Decap CMS for a Git-based editing experience

Common approaches

You can integrate a CMS in a few ways:

• export content into MDX files during build time
• fetch published content into Astro and render it directly
• use Git-backed CMS tools that commit changes into src/content/docs

Keep the content model stable

Even if you adopt a CMS, it helps to keep Compass categories and article metadata aligned with the same fields:

• title
• description
• category
• order
• updated date