Install

@calibrate-ds/dna is a standalone npm package. It does not depend on @calibrate-ds/cli (PTB) — the two are independent products that can be used separately or together.

Requirements

Node.js >= 18.17.

npm install -g @calibrate-ds/dna

Once installed, the dna command is available directly:

dna --version
dna check

One-off with npx

Note the full package namedna alone resolves an unrelated package on npm:

npx @calibrate-ds/dna check
npx @calibrate-ds/dna start

Optional peers

DNA's core installs with a single dependency (postcss) and degrades cleanly when peers are missing — it always tells you what it skipped and why.

PeerRequired for
typescript >= 5dna inventory and dna similar (JSX/TSX parsing)
puppeteer-core >= 20dna check --only=render (headless rendered conformance)

Install peers only if you need those features:

# For inventory and similar
npm install -D typescript

# For rendered checks
npm install -D puppeteer-core

Next steps

Run dna start to extract your codebase's design identity. See the Quickstart for the full first-run walkthrough.