# Vesper

> Vesper builds an editor from your Astro site's content collections. Content stays as files in your repository, and the site stays static, on any host.

Every docs page is also Markdown: add .md to its address in place of the trailing slash. All of them in one file: https://vespercms.com/llms-full.txt

For a site that uses Vesper, `npx vesper agents` writes instructions for coding agents, generated from that site's own schema, into its AGENTS.md.

## Introduction

- [Introduction](https://vespercms.com/docs.md): Vesper adds an editor to your Astro site that reads your content collections and saves to the files in your repository.

## Getting started

- [Getting started](https://vespercms.com/docs/getting-started.md): Install Vesper, make a first edit in the studio on your own computer, then choose how edits reach the live site.
- [Install](https://vespercms.com/docs/getting-started/install.md): Add Vesper to an Astro site with one command, then open the studio.
- [Your first edit](https://vespercms.com/docs/getting-started/first-edit.md): A tour of the studio in local mode, from opening an entry to saving it, with the body editor, images and page trees.
- [Publishing](https://vespercms.com/docs/getting-started/publishing.md): How an edit reaches the live site in each mode, from committing local changes yourself to editors publishing from the deployed studio.

## Content

- [Content](https://vespercms.com/docs/content.md): How the studio reads your content collections, and where its presentation settings go.
- [Fields and widgets](https://vespercms.com/docs/content/fields.md): How each Zod type in your schema becomes a control in the studio, and how hints, helpers and custom widgets change it.
- [Images](https://vespercms.com/docs/content/images.md): Image fields with alt text, focal points and crops, what happens to an upload before it's saved, and how to render the result.
- [Pages, URLs and redirects](https://vespercms.com/docs/content/pages-and-urls.md): Give entries their addresses, arrange pages in a tree, move them safely, and keep old addresses working with redirects.
- [Markdoc and MDX](https://vespercms.com/docs/content/markdoc-and-mdx.md): How the body editor shows Markdoc tags and MDX components as blocks, what it keeps exactly as written, and what stops a save.

## On your site

- [On your site](https://vespercms.com/docs/site.md): What Vesper adds to the site it builds, and why all of it is plain static files.
- [Site search](https://vespercms.com/docs/site/search.md): Vesper indexes your site with Pagefind at every build, and one component gives visitors a search dialog that works on any host.
- [Accessibility checks](https://vespercms.com/docs/site/accessibility.md): Vesper checks content in the studio as it's edited, and every page at build, and reports what it finds in plain words.
- [Hosting](https://vespercms.com/docs/site/hosting.md): The built site and the studio are plain static files, so they work on any host, from Netlify to a shared host you upload to by FTP.

## AI coding agents

- [AI coding agents](https://vespercms.com/docs/agents.md): Give a coding agent your site's content rules with one command, and point it at these docs as Markdown.

## Reference

- [Reference](https://vespercms.com/docs/reference.md): Every setting Vesper reads, with its default, and the vesper command.
- [Configuration](https://vespercms.com/docs/reference/integration.md): Every option of vesper() in astro.config.mjs and every key of vesper.config.ts, with its default.
- [The vesper command](https://vespercms.com/docs/reference/cli.md): vesper agents writes instructions for coding agents, and vesper manifest shows what Vesper reads from your site.