Config commands

avo theme

Six built-in themes (textbook is the default, plus minimal, soft, dark, teal, slate) and your own custom ones:

avo theme                       # interactive picker (✓ marks the current theme)
avo theme use dark              # set the theme for this project
avo theme use sunset --global   # set the default for every project
avo theme new sunset            # scaffold a custom theme to fill in
avo theme install ./my.theme.json   # add a theme file

A theme file starts from a base theme and overrides colors (primary, accent, ink, paper, …) or fonts (display, body, mono). No rebuild needed — just re-render.

The easiest way to make one: the theme generator on this site. Pick colors over a live preview and download the file.

avo sync

Generate Avodado content from data you already have:

avo sync openapi spec.yaml --out docs/api.md   # a full API doc from an OpenAPI spec
avo sync csv sales.csv                         # a ready-to-paste block from a CSV
avo sync csv sales.csv --out docs/sales.md     # or a whole new doc

The output is normal Avodado Markdown — edit and validate it like anything else.

avo sync csv picks the best block for your data — a status column becomes a statustable, numeric columns become a chart, anything else a table — and tells you why. Override with --block table|statustable|chart.

For CI, avo sync openapi --check fails when the doc has drifted from the spec.