Repolode
Submit
davidvkimball

davidvkimball/vaultcms

A headless CMS that uses Obsidian as the content editor for an Astro website, with Markdown files as the source of truth.

View on GitHubWebsite
Stars
391
Forks
22
Open issues
0
Last commit
last month

What is it?

Vault CMS turns an Obsidian vault into a publishing workspace for Astro sites. Content stays as plain Markdown files, so you write and organize posts in Obsidian while Astro builds the site from the same folder.

The project detects your Astro routes and content structure automatically, and provides a visual grid homepage where you can review content and run bulk actions. It ships with preconfigured Obsidian settings, hotkeys, and plugins aimed at the Astro workflow.

Installation is done with a CLI (npx create-vaultcms) that detects your Astro project and offers presets for themes such as Starlight, Slate, and Chiri. An MCP server is also included so AI agents such as Claude Code or Cursor can perform the installation through tool calls.

Key features

  • 01Automatically detects Astro routes and content structure.
  • 02Visual grid homepage with bulk actions for content.
  • 03Preconfigured Obsidian settings, hotkeys, and plugins.
  • 04Plain Markdown files with no proprietary content format.
  • 05CLI installer with theme presets, plus an MCP server for AI agents.

Use cases

  • Writing and publishing a blog or docs site for Astro from Obsidian.
  • Managing Markdown content for an Astro theme such as Starlight without a separate CMS.
  • Letting an AI coding agent set up an Astro content workflow via MCP.

Quick start

  1. 1

    Run the CLI at your Astro project root (npm)

    npm create vaultcms
  2. 2

    Or use npx to run the installer

    npx create-vaultcms
  3. 3

    Choose a preset when prompted (e.g. Starlight, Slate, Chiri), then open the folder as a vault in Obsidian

Things to know

  • Requires an Astro project; it is not a standalone CMS.
  • Requires using the Obsidian desktop or mobile app to edit content.

In collections

Static site generators & documentation tools

Topics

#astro#obsidian#markdown#headless-cms#static-site#content-management#astrojs#obsidian-md#obsidian-template#obsidian-vault

FAQ

What is vaultcms?
A headless CMS that uses Obsidian as the content editor for an Astro website, with Markdown files as the source of truth. Vault CMS turns an Obsidian vault into a publishing workspace for Astro sites. Content stays as plain Markdown files, so you write and organize posts in Obsidian while Astro builds the site from the same folder.
Is vaultcms free to use? What license does it have?
vaultcms is open source under the MIT license. Check the license terms before using it in commercial products.
Is vaultcms still maintained?
Updated within 6 months. The last commit to vaultcms was on Oct 3, 2026.
What can I use vaultcms for?
Writing and publishing a blog or docs site for Astro from Obsidian. Managing Markdown content for an Astro theme such as Starlight without a separate CMS. Letting an AI coding agent set up an Astro content workflow via MCP.
How do I install vaultcms?
Run the CLI at your Astro project root (npm): npm create vaultcms Or use npx to run the installer: npx create-vaultcms Choose a preset when prompted (e.g. Starlight, Slate, Chiri), then open the folder as a vault in Obsidian
Where can I get vaultcms?
The source code and installation instructions are on GitHub: https://github.com/davidvkimball/vaultcms

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects