# dtheo/ui > 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. Every docs page has a Markdown mirror at the same URL with `.md`. The MCP server at /mcp (Streamable HTTP, read-only) exposes the same contracts as tools. The registry at /r/registry.json is shadcn-compatible. ## Get started - [Introduction](https://ui.dtheo.dev/docs/index.md): Pick what you are building, get one command. - [Components](https://ui.dtheo.dev/docs/components.md): Every component, live, on one page. - [Installation](https://ui.dtheo.dev/docs/installation.md): Add dtheo/ui to a Next.js or Vite app. - [Theming](https://ui.dtheo.dev/docs/theming.md): Presets, light and dark, scoped themes. - [For agents](https://ui.dtheo.dev/docs/agents.md): MCP server, llms.txt, Markdown pages and the CLI. - [CLI](https://ui.dtheo.dev/docs/cli.md): Add components and check UI code. - [Atomic design](https://ui.dtheo.dev/docs/atomic-design.md): How the system is layered, and what uses what. ## Foundations - [Color](https://ui.dtheo.dev/docs/foundations/color.md): OKLCH roles, presets and measured contrast. - [Typography](https://ui.dtheo.dev/docs/foundations/typography.md): System fonts, roles and size-specific tracking. - [Geometry](https://ui.dtheo.dev/docs/foundations/geometry.md): Control heights, concentric radii, borders and elevation. - [Motion](https://ui.dtheo.dev/docs/foundations/motion.md): Curves, durations and when not to animate. ## Components - [Button](https://ui.dtheo.dev/docs/components/button.md): Triggers an action. One primary button per view marks the action that matters most. - [Toggle and segmented control](https://ui.dtheo.dev/docs/components/toggle.md): A pressed/unpressed button, and a segmented control for a few mutually exclusive modes. - [Input](https://ui.dtheo.dev/docs/components/input.md): A single-line text field. Aligns with buttons and selects of the same size. - [Field](https://ui.dtheo.dev/docs/components/field.md): Groups a label, a control, help text and an error, and wires their ids for assistive tech. - [Input group](https://ui.dtheo.dev/docs/components/input-group.md): A text field with an icon, unit, keyboard hint or small button inside its border. - [Textarea](https://ui.dtheo.dev/docs/components/textarea.md): Multi-line text that grows with its content, then scrolls. - [Number field](https://ui.dtheo.dev/docs/components/number-field.md): A number with steppers, a unit and a scrubbable label. Formats with the user’s locale. - [Select](https://ui.dtheo.dev/docs/components/select.md): Choose one option from a list. The popup aligns the selected item over the trigger, as macOS does. - [Combobox](https://ui.dtheo.dev/docs/components/combobox.md): A searchable select for long lists, with a clear button and an explicit empty state. - [Checkbox](https://ui.dtheo.dev/docs/components/checkbox.md): Turns an independent option on or off, including an indeterminate “some selected” state. - [Radio group](https://ui.dtheo.dev/docs/components/radio-group.md): One choice from a short list that stays visible. - [Switch](https://ui.dtheo.dev/docs/components/switch.md): An on/off setting that takes effect immediately. - [Slider](https://ui.dtheo.dev/docs/components/slider.md): A value on a continuous track; pass two values for a range. - [Dialog](https://ui.dtheo.dev/docs/components/dialog.md): A modal task. Focus moves in, the page behind is inert, Escape closes and focus returns to the trigger. - [Alert dialog](https://ui.dtheo.dev/docs/components/alert-dialog.md): Confirms a destructive or irreversible action; clicking outside does not dismiss it. - [Sheet](https://ui.dtheo.dev/docs/components/sheet.md): A panel that slides in from an edge and can be swiped away: inspectors, edit forms, mobile navigation. - [Popover](https://ui.dtheo.dev/docs/components/popover.md): Non-modal content anchored to its trigger: filters, quick settings, details. - [Tooltip](https://ui.dtheo.dev/docs/components/tooltip.md): A short label for an icon-only control. After the first, neighbours open instantly. - [Menu](https://ui.dtheo.dev/docs/components/menu.md): Actions or options behind a trigger, with groups, checkable items, submenus and shortcuts. - [Command palette](https://ui.dtheo.dev/docs/components/command.md): A ⌘K palette to jump anywhere and run any command. Opens instantly, no animation. - [Toast](https://ui.dtheo.dev/docs/components/toast.md): A brief confirmation that stacks, expands on hover, pauses when hidden and swipes away. - [Tabs](https://ui.dtheo.dev/docs/components/tabs.md): Switches between views of the same object, as a segmented control or an underline. - [App shell](https://ui.dtheo.dev/docs/components/app-shell.md): The frame of a product: translucent sidebar, sticky toolbar, page header; the sidebar becomes a sheet on phones. - [Alert](https://ui.dtheo.dev/docs/components/alert.md): An inline message about the current view: what happened and what to do next. - [Empty state](https://ui.dtheo.dev/docs/components/empty.md): What to show when there is nothing to show, with the reason and the next step. - [Progress and meter](https://ui.dtheo.dev/docs/components/progress.md): Progress shows task completion; Meter shows a measurement against its range and limit. - [Spinner and skeleton](https://ui.dtheo.dev/docs/components/spinner.md): An Apple-style activity indicator, and placeholders shaped like the content that is loading. - [Badge](https://ui.dtheo.dev/docs/components/badge.md): A short status or category label. Status always carries a word, never color alone. - [Card](https://ui.dtheo.dev/docs/components/card.md): A grouped surface with header, content and footer. Depth from a lighter fill and a hairline. - [Metric](https://ui.dtheo.dev/docs/components/metric.md): A measurement with its unit, a meter against its limit and a status that pairs an icon with a word. - [Table](https://ui.dtheo.dev/docs/components/table.md): A semantic data table with right-aligned tabular numbers, selection and contained horizontal scroll. - [Avatar](https://ui.dtheo.dev/docs/components/avatar.md): A person or team, falling back to correct initials (graphemes, suffixes, emoji) when there is no image. - [Kbd](https://ui.dtheo.dev/docs/components/kbd.md): A keyboard key or shortcut with platform glyphs. - [Accordion](https://ui.dtheo.dev/docs/components/accordion.md): Sections that expand in place. Good for FAQs and secondary settings. - [Separator](https://ui.dtheo.dev/docs/components/separator.md): A hairline between groups, for when spacing alone does not separate them. - [Scroll area](https://ui.dtheo.dev/docs/components/scroll-area.md): A scroll container with overlay scrollbars and edge fades only where content overflows. ## Charts - [Line chart](https://ui.dtheo.dev/docs/charts/line-chart.md): Engineering traces with limits, bands, markers, a synced crosshair, keyboard reading and downsampling. - [Bar chart](https://ui.dtheo.dev/docs/charts/bar-chart.md): Comparison across a few categories; bars past the limit turn critical so the outlier reads first. - [Heatmap](https://ui.dtheo.dev/docs/charts/heatmap.md): A sequential map over two axes, such as motor efficiency over speed and torque. - [Sparkline](https://ui.dtheo.dev/docs/charts/sparkline.md): A word-sized trend with an emphasized endpoint. - [Stream chart](https://ui.dtheo.dev/docs/charts/stream-chart.md): A live time series for telemetry: newest sample at the right edge, limits, and anything past a limit in red. - [Frequency chart](https://ui.dtheo.dev/docs/charts/frequency-chart.md): Frequency response on a log axis: a spectrum, or a Bode plot with gain and phase margins drawn where they are measured. - [Scatter chart](https://ui.dtheo.dev/docs/charts/scatter-chart.md): The relationship between two measurements across many runs, with limits, a fit line and one point called out. - [Histogram](https://ui.dtheo.dev/docs/charts/histogram.md): A distribution against specification limits, with n, mean, standard deviation and Cpk stated in words. ## Patterns - [Data table](https://ui.dtheo.dev/docs/patterns/data-table.md): Search, filter, sort, select and recover. - [Forms](https://ui.dtheo.dev/docs/patterns/forms.md): Validation, dirty state and a failed save. - [States](https://ui.dtheo.dev/docs/patterns/states.md): Loading, empty, no results, no permission, error. ## Optional - [Run review](https://ui.dtheo.dev/examples/run-review): Actuator step response: what failed and what to do next. - [Motor map](https://ui.dtheo.dev/examples/motor-map): Efficiency over speed and torque, with an operating point. - [Loop tuning](https://ui.dtheo.dev/examples/tuning): Live telemetry, a Bode plot, a spectrum and 412 runs. - [Lab assistant](https://ui.dtheo.dev/examples/assistant): A chat that answers with tables and charts. - [Registry index](https://ui.dtheo.dev/r/registry.json): every installable item as JSON - [Full text](https://ui.dtheo.dev/llms-full.txt): every page in one file