# Design Token Authority

> The deterministic backbone for design token workflows, built for humans and agents: a CLI that syncs Figma variables with DTCG token files, lints them, builds CSS, JavaScript and Tailwind outputs, and shows token changes and their visual effect in pull requests.

The full text of every page below is in [/llms-full.txt](https://dta.martinprinz.dev/llms-full.txt). The config JSON Schema is at [/schemas/dta.config.schema.json](https://dta.martinprinz.dev/schemas/dta.config.schema.json), the token-file JSON Schema at [/schemas/token-file.schema.json](https://dta.martinprinz.dev/schemas/token-file.schema.json), the JSON output of `dta token` at [/schemas/dta.token.schema.json](https://dta.martinprinz.dev/schemas/dta.token.schema.json), of `dta audit` at [/schemas/dta.audit.schema.json](https://dta.martinprinz.dev/schemas/dta.audit.schema.json).

## Start

- [What DTA is](https://dta.martinprinz.dev/start/): DTA checks design token changes deterministically, builds them for every platform and shows their effect before they ship.
- [Quick start](https://dta.martinprinz.dev/start/quick-start/): From token files to CSS in a few commands, with output from a real run.
- [Core concepts](https://dta.martinprinz.dev/start/concepts/): Collections, modes and token files; aliases; the layers of a token set; and what the build makes of them.

## Learn

- [The DTCG format](https://dta.martinprinz.dev/learn/): DTCG in short, and where DTA's token files differ from it.
- [Token patterns](https://dta.martinprinz.dev/learn/patterns/): Common ways to structure tokens, how they look in DTA, and where large design systems describe them.

## Guides

- [Guides](https://dta.martinprinz.dev/guides/): Getting tokens out of Figma, brands and themes, Tailwind, CI, dta diff, coding agents and migrating from v1.
- [Getting tokens out of Figma](https://dta.martinprinz.dev/guides/figma/): The REST API on Enterprise plans, plugin exports on every other plan, and pushing changes back.
- [Brands and themes](https://dta.martinprinz.dev/guides/brands-and-themes/): One token set with several brands, or light and dark, switched with one attribute.
- [Tailwind](https://dta.martinprinz.dev/guides/tailwind/): Use the generated @theme file with Tailwind v4, and keep brand colours switchable.
- [CI with GitHub Actions](https://dta.martinprinz.dev/guides/ci/): Lint and build the tokens on every push; fail on structural errors, keep warnings visible.
- [DTA with coding agents](https://dta.martinprinz.dev/guides/coding-agents/): Install the skill, generate the project context, and let the agent look tokens up and check its own code.
- [Migrating from v1](https://dta.martinprinz.dev/guides/migrate-from-v1/): What changes when you upgrade from DTA v1 to v2.
- [dta diff in pull requests](https://dta.martinprinz.dev/guides/dta-diff-in-pull-requests/): A status check and one comment per pull request, with screenshots explained by token, hosted wherever you publish.
- [dta diff with Storybook](https://dta.martinprinz.dev/guides/dta-diff-with-storybook/): Screenshot every story of a static Storybook build and explain the changes by token, without writing a stories manifest.

## Reference

- [Reference](https://dta.martinprinz.dev/reference/): Commands, configuration, token files, outputs, lint rules, token queries and exit codes.
- [Commands](https://dta.martinprinz.dev/reference/commands/): Every dta command and option, from the CLI's own help.
- [Configuration](https://dta.martinprinz.dev/reference/configuration/): Every key of dta.config.ts, from the config schema of the CLI.
- [Token files](https://dta.martinprinz.dev/reference/token-files/): The per-mode DTCG format DTA reads and writes, its JSON Schema, and the exports it converts.
- [Outputs](https://dta.martinprinz.dev/reference/outputs/): Every file dta build writes, where, and what is in it.
- [Lint rules](https://dta.martinprinz.dev/reference/lint-rules/): The rules dta lint always runs, the ones you configure, their options and severities.
- [Token queries](https://dta.martinprinz.dev/reference/token-queries/): dta token get, find and list, their output and the JSON shape for agents and scripts.
- [Exit codes](https://dta.martinprinz.dev/reference/exit-codes/): What 0, 1 and 2 mean, command by command.

## Contribute

- [Contribute](https://dta.martinprinz.dev/contribute/): How the code is organised, the rules every change follows, and how work is planned with specs and tickets.