Documentation

The reference half of this site. The guides walk you through building things; these pages tell you exactly what every surface does, with real output for all of it. Everything here is checked against the CLI that built this page.

The tool

• The CLI: all nineteen verbs, with their flags, envelopes, and exit codes.
• Configuration: cherry.exs, key by key, and how cherry config edits it without an editor.
• The build pipeline: the nine stages between your markdown and _site/, and why builds are byte-deterministic.

Content

• The content model: collections, frontmatter schemas, drafts, and the publish flow.
• Content components: figures, video facades, and callouts, from syntax to diagnostics.

Appearance

• Theming: the styling ladder, design tokens, light-dark() pairs, template overlays, provenance, and the HEEx lane.

Integration

• The machine surface: JSON envelopes, llms.txt, markdown mirrors, and how agents operate a site.
• Deploying: GitHub Pages, custom domains, base_path, and what the generated workflow does.