CLI Options
All flags accepted by create-cartwright.
create-cartwright is the public scaffolder for Cartwright shops. In the current v0.1.0-beta source it parses these flags:
| Flag | Default | What it does |
|---|---|---|
--yes, -y | false | Skip prompts and use defaults. Defaults are project name from the positional argument, Turso database choice, AI enabled, detected package manager, install enabled, and git enabled. |
--template <name> | generic | Industry template selector. The current public CLI accepts the value, but the template source ships only generic in v0.1. |
--pm <pnpm|npm|yarn|bun> | auto-detect | Override the package manager used for dependency install. |
--no-install | false | Skip dependency installation after the template is downloaded. |
--no-git | false | Skip git init, git add -A, and the initial commit. |
npx create-cartwright@latest my-shop --yes --template=generic --pm=pnpmThe interactive prompts ask for database choice and whether AI commerce features should be included. With --yes, the CLI selects Turso and enables AI.
The current public CLI source does not parse --db, --ai, or --no-ai yet. If you pass them today, Node's parseArgs rejects the unknown options. Use the prompts or --yes defaults until those flags land.
The documented non-interactive target contract is:
npx create-cartwright@latest my-shop --yes --db=turso --aiUse that form only after checking the installed CLI version supports it:
npx create-cartwright@latest --helpMarketplace subcommands
Inside a scaffolded project, the cartwright CLI can pull individual designs and Voices from the marketplace into your repo:
# Install a design pack (a Skin) — see /designs for the catalogue
npx cartwright design install <slug> # e.g. apex, halo, jungle
# Install a Voice (a vertical preset) — see /verticals
npx cartwright vertical install <slug> # e.g. kindergarten, carpenter, cafeBoth resolve a template ref. By default they use stable, which maps to the current DEFAULT_REF (the latest engine release); pass --ref next to track the development branch, or --ref vX.Y.Z to pin a tag:
npx cartwright design install apex --ref nextEach command scaffolds the pack into designs/<slug>/ (or verticals/<slug>/) and registers it, so you can select it in /admin/designs (or apply it from /admin/verticals) right away.