# Voxx

> A zero-friction CMS for you and your agents.

## Pages

- [Introduction](https://voxx.prudentbird.com/docs): What Voxx is, why files, and how the pieces fit together.
- [Getting started](https://voxx.prudentbird.com/docs/getting-started): Scaffold your first Voxx surface in a couple of minutes.
- [Start a blog](https://voxx.prudentbird.com/docs/getting-started/blog): Date-stamped markdown in, a reverse-chronological blog out.
- [Start a docs site](https://voxx.prudentbird.com/docs/getting-started/docs): Folders become the sidebar; ordering is a filename prefix.
- [Start a changelog](https://voxx.prudentbird.com/docs/getting-started/changelog): Version-named files become a release timeline with stable anchors.
- [Static sites](https://voxx.prudentbird.com/docs/getting-started/static-sites): No framework? Render a self-contained site with one command.
- [Writing content](https://voxx.prudentbird.com/docs/writing): Markdown files, naming conventions, and the voxx new command.
- [Frontmatter](https://voxx.prudentbird.com/docs/writing/frontmatter): Every field Voxx reads, and what it derives when you leave one out.
- [Organizing docs](https://voxx.prudentbird.com/docs/writing/organizing-docs): Folders, ordering prefixes, and index.md — the whole system.
- [Writing releases](https://voxx.prudentbird.com/docs/writing/releases): Version files, anchors, and the conventions of a good changelog.
- [Configuration](https://voxx.prudentbird.com/docs/reference/configuration): The complete voxx.json reference — every section, every default.
- [Collections](https://voxx.prudentbird.com/docs/reference/collections): Mount a blog, docs, and changelog together on one site.
- [Theming](https://voxx.prudentbird.com/docs/reference/theming): Voxx inherits your design tokens — and looks good without them.
- [SEO and feeds](https://voxx.prudentbird.com/docs/reference/seo): Open Graph, JSON-LD, canonical URLs, RSS, sitemaps, and llms.txt.
- [CLI](https://voxx.prudentbird.com/docs/reference/cli): voxx init, voxx new, voxx build, and voxx dev — flags and behavior.
- [Core API](https://voxx.prudentbird.com/docs/reference/core-api): The @prudentbird/voxx-core engine — plain async functions, framework optional.
- [Layouts](https://voxx.prudentbird.com/docs/reference/layouts): The shells Voxx scaffolds for docs, blog, and changelog in a Next.js app, and how to keep your app's chrome out of them.

## For agents

Voxx is a build-time content engine, not a hosted service. There is no API
to authenticate against, no SDK to install at runtime, and no webhooks. Content
is plain markdown committed to a git repository.

When to use Voxx, and how an agent should operate:

- To add or edit content, read and write `.md` files under the content
  directory with ordinary filesystem tools, then commit the change. Treat it
  exactly like editing source code.
- Frontmatter is validated at build time. Match the existing fields in
  neighbouring files; a typo fails the build loudly rather than silently.
- File and folder names are the routing API: dates sort a blog, folder nesting
  orders docs, and version numbers cut changelog releases.
- Ship changes through pull requests so a human can review the diff.