# WollyCMS

> The self-hosted, Astro-native headless CMS. Block-based composition, clean API, deploy anywhere.

WollyCMS is an open-source, self-hosted headless CMS purpose-built for Astro. It gives developers block-based content composition with a clean API, so teams can manage content without sacrificing code control.

## Key Features

- **Block-based composition**: Structure content as configurable blocks (headings, rich text, images, code, feature grids, and custom types) and compose them into pages
- **Astro-native integration**: First-class `@wollycms/astro` package for seamless data fetching and rendering
- **API-first architecture**: Clean REST API for pages, blocks, menus, media, and taxonomies
- **Self-hosted**: Deploy on Cloudflare Workers, Docker, or Node.js — you own your data
- **Custom block types**: Define your own block types in JSON for marketing pages, landing pages, documentation, and more
- **Media management**: Built-in file storage (Cloudflare R2, local filesystem)
- **Hierarchical menus**: CMS-driven navigation and footer menus
- **Preview & revisions**: Draft previews and content versioning
- **API keys & webhooks**: Developer-focused integrations
- **Open source**: MIT licensed

## Tech Stack

- Astro v6 (SSR)
- Cloudflare Workers / D1 / R2 (or Docker / Node.js)
- Tailwind CSS

## npm Packages

- `@wollycms/server` — Core CMS server
- `@wollycms/astro` — Astro integration
- `create-wolly` — Project scaffolding CLI

## Links

- Website: https://wollycms.com
- Documentation: https://docs.wollycms.com
- GitHub: https://github.com/wollycms/wollycms
- Features: https://wollycms.com/features
- About: https://wollycms.com/about
- Blog: https://wollycms.com/blog

## Getting Started

Install with `npm create wolly@latest` and follow the guide at https://docs.wollycms.com/getting-started/installation/

## Pages

- [Home](https://wollycms.com/): Landing page with product overview, live demo, feature grid, and code examples
- [Features](https://wollycms.com/features): In-depth feature breakdown with admin UI screenshots and competitor comparison
- [About](https://wollycms.com/about): Origin story, tech stack, and open-source details
- [Blog](https://wollycms.com/blog): Product updates and articles
- [Documentation](https://docs.wollycms.com): Full docs covering setup, core concepts, Astro integration, deployment, and API reference