design-parity

The top-level CLI for design-parity — prove a UI pull request is at parity with its intended design. Run it with no checkout:

npx design-parity run \
  --components "ui/Home.kt#HomeScreen" \
  --candidate-bundles build/compose-previews/ \
  --out .design-parity/out

shard + merge — one run across N jobs

A catalog big enough that one job can't compare it inside a timeout doesn't have to be narrowed down to a hand-picked subset. Split the same exhaustive component list across parallel jobs and union the results:

# In job i of N: what this shard renders, and what it must not render.
npx design-parity shard --shard 2/6 --repo . --field previewId
npx design-parity shard --shard 2/6 --repo . --field previewId --complement

# Compare this shard's slice. Note: given the FULL component list — `--shard`
# partitions what it is handed, so passing a pre-sliced list slices it twice.
npx design-parity run --repo . --components "$ALL" --shard 2/6 \
  --candidate-bundles build/design-parity/candidates.bundle.png \
  --out build/design-parity/out

# Then, once: reassemble the shards into the artifact set one serial run
# would have written. Exits 1 on a blocking verdict — after writing the files.
npx design-parity merge shards/* --out .design-parity/out

Most consumers don't wire this by hand: the reusable workflow is the whole pipeline behind a shards: number. See docs/PARALLEL_PARITY.md.

reverse — design → code

Ask the committed design-map.json which code implements a design node — the direction a source without Code Connect (Stitch, Claude Design, bundle) otherwise can't answer. Every node of a multi-node binding points back at its code handle.

npx design-parity reverse figma:AbCdEf/1:42   # → ui/Home.kt#HomeScreen
npx design-parity reverse --repo .            # dump the whole ref → code map

Exit codes: 0 found (or full dump), 1 the ref maps to nothing, 2 no readable design-map.json.

This package is a thin launcher over @design-parity/action: it owns the design-parity bin so the bare npx design-parity invocation works, and it re-exports the orchestrator's programmatic API (import { orchestrate } from "design-parity"). The candidate side is rendered by the upstream compose-preview CLI — design-parity owns the reference side and the diff.

See the repo README and the CMP adoption guide for the full pipeline.