@hollware/nuxt

Hollware

A headless CMS for the agent era, native to Cloudflare.

[!WARNING] 1.0 release candidate. npm create hollware@rc installs it. Agents write and publish over MCP with contracts on every write, people review in an admin with passkeys, sites read over a service binding or HTTP, images live in R2, and one deployment serves several sites. From 1.0 the API follows semver (Versions and stability). The docs are at hollware.com; what is left before 1.0 is tracked in PLAN.md.

Get started

npm create hollware my-cms

It makes a project, its local database, your site and a token, and prints the command that connects Claude Code to it. The quickstart goes from there to a deployed Hollware.

Hollware is designed for teams that already have a frontend and want their AI agents to write the content. Agents write Markdown over MCP, contracts check every write, and sites read what was published from Hollware, which runs in your own Cloudflare account.

Principles

Hollware's thesis is stated as five principles. They describe what Hollware is committed to be, not what exists today. If a future decision contradicts one, the decision changes or the principle is rewritten in an ADR, never silently.

1. Headless, always. Hollware does not render sites and has no themes. It delivers content to any frontend: Nuxt, Astro, Next or the app of a product.
2. The agent is the primary editor. MCP is the first-class interface. The admin exists to review and approve, and everything it does can also be done over MCP.
3. Contracts at write time. Quality rules run when content is written. The error goes back to the agent within milliseconds, with an instruction on how to fix it, instead of failing a CI pipeline ten minutes later.
4. Markdown is the source of truth. It is what agents write and read best, and it produces readable diffs. Comark compiles it into a derived document that can be regenerated at any time.
5. Cloudflare-native, close to zero cost. Every piece uses a Cloudflare primitive with a free tier, and it all deploys to your own account. The target is $0 to $5 a month for two sites.

How it works

• Agents write over MCP. An agent creates or updates an entry as Markdown with frontmatter, through the Model Context Protocol.
• Contracts validate on write. Every write is checked against the collection's contracts: the frontmatter schema, the components allowed in the body and rules across entries. Violations come back to the agent with an instruction on how to fix them. They block publishing, not saving a draft.
• D1 is the single source of truth. Entries and their append-only revisions live in D1, Cloudflare's SQL database. An edit made on top of a stale version is rejected as a conflict instead of overwriting newer work.
• Sites read what was published. A site on Cloudflare reads over Workers RPC through a service binding: typed, without crossing the public internet, and with no token to manage. Sites elsewhere read over HTTP with a read token, or with @hollware/nuxt.

Out of scope

Some things are deliberately not part of Hollware:

• Rendering sites or shipping themes.
• A visual page builder.
• A plugin marketplace.
• Running outside Cloudflare, not before v1.
• Importing from WordPress, not before v1.

Roadmap

Each stage ends with an exit criterion that can be verified. The stage-by-stage plan, with its progress and the evidence for each step, is in PLAN.md.

Packages

Eleven packages, released together at one version, in the order they arrived.

Contributing

Contributions are welcome. CONTRIBUTING.md explains how to set up the repository and what a good pull request looks like, and everyone taking part is expected to follow the Code of Conduct. Coding agents start from AGENTS.md.

Report security vulnerabilities privately, never in a public issue. SECURITY.md explains how.

The name

Hollow is a CMS with no head and no servers to run, and hollowware is tableware, like teapots and pitchers, made to hold and serve. The name is also a nod to World of Warcraft's Hallow's End and its Headless Horseman.

License

Hollware is released under the MIT License.