Skip to content
Back to search

dtheo-ui

Pixel-perfect UI, even when your agent writes it. React components and engineering charts with an MCP server and a design linter built in.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 20 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/DimitrisTheo-Dev/dtheo-ui with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/DimitrisTheo-Dev/dtheo-ui'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dimitristheo-dev--dtheo-ui/badge.svg)](/listings/dimitristheo-dev--dtheo-ui)

HTML

<a href="/listings/dimitristheo-dev--dtheo-ui"><img src="/api/listings/dimitristheo-dev--dtheo-ui/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 104 lines
  1. <p align="center">
  2. <a href="https://ui.dtheo.dev"><img src=".github/assets/hero.png" alt="dtheo/ui: pixel-perfect UI, even when your agent writes it." width="100%" /></a>
  3. </p>
  4. <h1 align="center">dtheo/ui</h1>
  5. <p align="center">
  6. Components and engineering charts for data-heavy React apps,<br />
  7. with an MCP server and a design linter built in.
  8. </p>
  9. <p align="center">
  10. <a href="https://ui.dtheo.dev"><strong>ui.dtheo.dev</strong></a> ·
  11. <a href="https://ui.dtheo.dev/docs/components">Components</a> ·
  12. <a href="https://ui.dtheo.dev/docs/agents">For agents</a> ·
  13. <a href="https://ui.dtheo.dev/examples/tuning">Live example</a>
  14. </p>
  15. <p align="center">
  16. <a href="https://github.com/DimitrisTheo-Dev/dtheo-ui/actions/workflows/ci.yml"><img src="https://github.com/DimitrisTheo-Dev/dtheo-ui/actions/workflows/ci.yml/badge.svg" alt="CI" /></a>
  17. <a href="https://www.npmjs.com/package/dtheo"><img src="https://img.shields.io/npm/v/dtheo?label=npx%20dtheo" alt="npm" /></a>
  18. <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT license" /></a>
  19. </p>
  20. ---
  21. ## Start
  22. **You:**
  23. ```bash
  24. npx dtheo init
  25. npx dtheo add button table line-chart
  26. ```
  27. **Your agent:**
  28. ```bash
  29. claude mcp add --transport http dtheo https://ui.dtheo.dev/mcp
  30. ```
  31. Components are copied into your project, so you own the code. Every item also installs with the shadcn CLI.
  32. ## Why it is different
  33. - **Charts that know what a limit is.** Line, bar, heatmap, sparkline, a live 1 kHz stream, frequency response
  34. (spectrum and Bode with gain and phase margins), scatter with a fit, and a histogram that states Cpk. Most are
  35. readable with the arrow keys.
  36. - **Your agent already knows it.** An MCP server with 7 tools, `llms.txt`, and a Markdown copy of every page. The
  37. page you read, the Markdown an agent reads and the MCP answer all come from one component contract.
  38. - **Mistakes caught before review.** `npx dtheo check` runs 17 rules for what agents get wrong (raw colors,
  39. `transition-all`, icon buttons without a name, off-system radii…), each with the fix. It exits 1 in CI.
  40. - **Contrast is proven, not promised.** 116 text and UI color pairs are measured on every token build, layered
  41. surfaces included. The build fails below WCAG AA.
  42. - **Feels native.** System type, Mac materials, one accent, a focus ring you can always see. Three presets
  43. (Graphite, Flight deck, Deep space), light and dark, scoped to any element.
  44. ## What is inside
  45. | | |
  46. | --- | --- |
  47. | **36 components** | On [Base UI](https://base-ui.com) and Tailwind CSS v4: fields, selects, menus, dialogs, sheets, toasts, tables with Shift-click range selection, metrics, an app shell… |
  48. | **8 charts** | SVG drawn by React, canvas for live and dense data, d3 for the math. No chart library. |
  49. | **Tokens** | OKLCH roles in shadcn's vocabulary, exported as CSS, DTCG JSON and hex for React Native and Expo |
  50. | **4 example apps** | Run review, Motor map, Loop tuning, Lab assistant: full screens built only from the system, on synthetic data |
  51. | **CLI** | `dtheo init`, `add`, `list`, `check`, `rules`, `mcp` |
  52. ## How it is built
  53. ```
  54. packages/tokens One OKLCH source → CSS, DTCG JSON, React Native hex and a contrast report
  55. packages/ui Components on Base UI, and the component contracts (src/meta) that drive everything else
  56. packages/charts Charts: SVG via React, canvas for live and dense data, d3 for scales and binning
  57. packages/cli `dtheo`: copies components from the registry and runs the design check
  58. apps/docs ui.dtheo.dev: docs, examples, the registry, the MCP server, llms.txt and Markdown mirrors
  59. e2e Playwright: every route at desktop and phone width, axe in both themes, interactions, pixels
  60. ```
  61. Every change runs through:
  62. | Gate | What it proves |
  63. | --- | --- |
  64. | `pnpm tokens:check` | Token outputs are current and every contrast pair passes AA |
  65. | `pnpm lint` · `pnpm typecheck` | oxlint with React Compiler rules, strict TypeScript across the workspace |
  66. | `pnpm test` | Contracts, registry, usage graph, CLI and every design-check rule |
  67. | `pnpm design:check` | The repo passes its own design check, with every exception explained |
  68. | `pnpm test:e2e` | No errors or sideways scroll on any route, no serious axe violations, real interactions |
  69. | `pnpm test:visual` | Pixel diffs of the screens that define the look |
  70. ## Develop
  71. ```bash
  72. corepack enable && pnpm install
  73. pnpm dev # http://localhost:4100
  74. pnpm check # tokens, lint, types, unit tests, design check
  75. pnpm test:e2e # browser tests
  76. ```
  77. Start at [AGENTS.md](AGENTS.md) for the rules of the codebase and [DESIGN.md](DESIGN.md) for the decisions behind
  78. the look.
  79. ## License
  80. [MIT](LICENSE) © Dimitris Theodoropoulos

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.