Changelog

The CLI reference page is now generated straight from vark --help, so every flag and subcommand stays in lockstep with the code:

• No hand-maintained option tables to drift
• Each subcommand is documented from its own --help

See the CLI reference for the full command list.

vark dev keeps edit-loop rebuilds fast by skipping the build’s heaviest publish phases — Open Graph card rendering and the whole-site PDF — which only matter when you ship. Full vark build output is unchanged. Why aardvark still re-renders every page covers the design thinking.

Every code block — on the page, in the file-tree modal, and in OpenAPI request/response samples — now shares one Copy and Download affordance, so the interaction is identical everywhere a reader meets code. See the components library.

Operation and schema descriptions from your OpenAPI spec are now part of the search index, so a reader searching for an endpoint’s behavior lands on the right reference section — not just pages that happen to mention it in prose.

An optional Ask AI assistant answers reader questions grounded in your docs, backed by a metered cloud gateway. Bring your own key, or use the bundled, capped allowance to try it out.

vark build now runs a non-fatal WCAG color-contrast audit over your theme colors (light and dark) and reports any pair that falls below the configured level, so regressions surface before they ship. Read more under Accessibility.

Every page can render a branded 1200×630 Open Graph card — your logo over a gradient of the theme’s primary color — rendered fresh under _aardvark/og/ on every production build, and skipped entirely by vark dev so the editing loop stays fast.

Serve translated content from per-language directories with an automatic language picker. vark build --translate fills missing or changed pages with a model, grounded in the site’s definitions glossary; unchanged pages are skipped via a content-hash cache.

Embed any Mantine component as an interactive island straight from Markdown. Islands are optionally prerendered to static HTML at build time for crawlers and first paint, then rehydrated on the client for full interactivity.