dtcg-tools

CLI for DTCG 2025.10 design tokens.

It validates token JSON, converts JSON tokens to CSS variables, and generates a static HTML showcase from JSON or CSS.

Install

Run without installing:

npx dtcg-tools validate tokens.json

Or install globally:

npm install -g dtcg-tools
dtcg-tools validate tokens.json

Requires Node.js 18 or newer.

Commands

| Command | Accepts | Output | | --- | --- | --- | | validate | JSON file, JSON URL, stdin JSON | validation result | | convert | JSON file, JSON URL, stdin JSON | CSS | | showcase | JSON/CSS file, JSON/CSS URL, stdin JSON/CSS | HTML showcase |

Validate

dtcg-tools validate tokens.json
dtcg-tools validate https://example.com/tokens.json
cat tokens.json | dtcg-tools validate

Use another validation engine:

dtcg-tools validate tokens.json --engine ajv
dtcg-tools validate tokens.json --engine all

Engines: dispersa default, ajv, terrazzo, all.

Convert

Print CSS to stdout:

dtcg-tools convert tokens.json
dtcg-tools convert https://example.com/tokens.json
cat tokens.json | dtcg-tools convert

Write CSS to a file:

dtcg-tools convert tokens.json --output tokens.css
dtcg-tools convert https://example.com/tokens.json --output tokens.css

Convert multiple JSON inputs to multiple CSS files:

dtcg-tools convert light.json dark.json --output light.css --output dark.css

convert accepts only JSON inputs, because it converts DTCG JSON to CSS.

Showcase

Generate HTML from JSON:

dtcg-tools showcase tokens.json
dtcg-tools showcase https://example.com/tokens.json

Generate HTML from CSS:

dtcg-tools showcase tokens.css
dtcg-tools showcase https://example.com/tokens.css

Mix inputs. Each input becomes a tab:

dtcg-tools showcase light.css dark.json https://example.com/brand.json

Write HTML to a file and open it in the default browser:

dtcg-tools showcase tokens.json --output showcase.html

Read from stdin:

cat tokens.json | dtcg-tools showcase
cat tokens.css | dtcg-tools showcase

Notes

• --output name.html writes to a temporary directory.
• --output path/name.html writes to that path.
• Repeating --output for convert must match the number of JSON inputs.

License

MIT