cfgx-cli

CLI for CFG — cfgx scaffolds a standalone configurator app and validates definition.md files in CI.

npx cfgx-cli start my-configurator --init=demo
cd my-configurator && pnpm install && pnpm dev

cfgx validate src/definition.md

Commands

• cfgx start <project-name> [--init=demo|coffee|blank] — scaffolds a standalone Vite+Svelte app into ./<project-name>. Templates:

  • demo — the motorboat configurator (apps/demo's definition + data + boat SVGs)
  • coffee — the tutorial's coffee-machine configurator (examples/coffee)
  • blank (default) — a minimal one-class starter with comments pointing at docs/reference.md

  Refuses to overwrite an existing non-empty directory.

• cfgx validate <definition.md> — parses the definition and prints either a green summary (classes/rules/sections/steps counts) or each error as line N: message, exiting non-zero on failure. This is the CI story: run it as a pre-merge check on every definition.md change.

• cfgx --help — usage.

Part of the CFG monorepo.

License: MIT