CLI reference

Reference for the Solo commands available in the Frontmatter CLI.

If you're using the downloaded Solo package, run the bundled binary as ./bin/frontmatter or add bin/ to your PATH.

frontmatter solo:validate

Validates the project against the Solo validation contract. Does not generate anything.

frontmatter solo:validate [options]

frontmatter solo:build

Validates and generates the full render pack. If validation fails, Solo prints the diagnostics summary and the same AI tip shown by solo:validate.

frontmatter solo:build [options]

Examples

# Validate a project
frontmatter solo:validate --root .

# Show the built-in AI workflow guide
frontmatter solo:validate --help-ai

# Twig output
frontmatter solo:build --adapter twig

# PHP output with custom output dir
frontmatter solo:build --adapter php --out ./theme/solo

# Twig with preview, clean output
frontmatter solo:build --adapter twig --emit-preview --clean

# Strict mode — warnings become errors
frontmatter solo:build --adapter twig --strict

Validation error summary

E201 src/pages/index.astro:13 Non-literal props used in component Hero.
  Fix: Use only string, number, boolean, or null props in Solo v1.

──────────────────────────────────────────
1 error · 0 warnings

Tip: use the AI workflow to fix these errors automatically.
     frontmatter solo:validate --help-ai
──────────────────────────────────────────

Exit codes