CLI reference

Commands

1 min read

The CLI follows a flat designdrop <command> structure. Every command exits 0 on success and non-zero on any failure (validation error, network failure, file conflict). Use --help on any command for the full flag list.

add

Install a curated DESIGN.md into the current project.

designdrop add stripe
designdrop add vercel --out apps/web/DESIGN.md
designdrop add airbnb --force
designdrop add notion --all --out design/

Flags: --out PATH, --force, --all. Refuses to overwrite by default.

list

List all curated brand-inspired design systems.

designdrop list
designdrop list --category Editorial
designdrop list --json | jq '.[].slug'

Flags: --category NAME, --json. Defaults to a clean ANSI table.

search

Substring match across slug, name, description, and category.

designdrop search saas
designdrop search "warm coral"
designdrop search Brutalist --json

Exits 1 on empty query so it composes well in scripts.

validate

Lint a local DESIGN.md against the schema. Reports issues with line numbers and suggested fixes.

designdrop validate                 # validates ./DESIGN.md
designdrop validate apps/web/DESIGN.md
designdrop validate --emit          # also writes derived tokens.css / tokens.dtcg.json

Exits 0 only when there are no issues. Warnings (e.g. dark theme parity) are reported but don't fail the run.

generate

Submit a URL extraction job and poll until it terminates. Requires designdrop login.

designdrop generate https://stripe.com
designdrop generate https://vercel.com --out vercel-DESIGN.md --theme both

Flags: --out PATH, --theme auto|light|dark|both, --no-save (just print, don't write).

OAuth round-trip. The CLI opens your browser, completes the flow on app.designdrop.app, and stores the token in your OS keychain.

designdrop login
designdrop logout

completion

Print a shell completion script. Pipe into your shell config — see Installation.

designdrop completion bash
designdrop completion zsh
designdrop completion fish