# Introduction

> dtheo/ui is a React design system for data-dense engineering tools: native-feeling components on Base UI, custom engineering charts, OKLCH tokens with contrast checked at build time, and an MCP server, CLI and llms.txt so agents build with it as well as people do.

dtheo/ui is built for the tools engineers use every day: run reviews, dashboards, trackers and assistants. The interfaces are dense where the data needs it and calm everywhere else, so a first-time user can find the problem and the next step without asking.

## Principles

- **Color marks attention.** Surfaces are neutral. Green, amber and red appear only when something needs a person, and always with a word or an icon.
- **Native by default.** System fonts, Mac-like materials, a focus ring you can always see, motion that responds immediately and never makes you wait.
- **Summary before detail.** Checks first, then the evidence (charts, tables), then the record.
- **One source of truth.** Each component has one contract that drives its page, its Markdown, the registry, the MCP server and the CLI.
- **Proof over claims.** Every text color pair is contrast-checked when tokens build; the build fails below WCAG AA.

## What is in the box

- 35 components on Base UI, styled with Tailwind CSS v4 and OKLCH tokens.
- 8 engineering charts: line (limits, bands, synced crosshair, keyboard reading), bar, heatmap, sparkline, a live stream chart, frequency (spectrum and Bode with margins), scatter and histogram (spec limits and Cpk).
- 3 presets: Graphite (default), Flight deck and Deep space, each a different character from the same components.
- Agent surfaces: `/llms.txt`, a `.md` mirror of every page, a shadcn-compatible registry, an MCP server at `/mcp`, and the `dtheo` CLI with a design checker.
