# shadcn/ui Tokens and data. Reviewed November 9, 2026. https://bestaireadydesignsystems.com/directory/shadcn-ui/ ## Answer in brief shadcn/ui scores 7 of 8 and shares fifth place on the ranking. Its agent tooling is strong: an official MCP server that finds and installs components, an llms.txt with a Markdown copy of every page, and a skill. It loses 1 point on design tokens, because its theme is CSS variables and no design token file is documented for programs to read. Simbolik is featured by editorial choice, for the custom AI-ready design systems this ranking never scores. Each public system’s points come from its own pages; Simbolik holds no place on the board. ## Its score on the board shadcn/ui scores 7 of 8 and shares fifth place with Chakra UI and Shopify Polaris. The ratings come from its own docs and repository, and it has no tie to Simbolik. It is not a package you install and call; it is source code you copy, which shapes both its strengths and its one lost point. ## The 5 signs and their proof The first 4 signs make the score out of 8: 2 points for a Yes, 1 for a Partly, none for a No. Typed props are rated beside them and left out of the score. - **Design tokens: Partly, 1 point.** The theme is CSS variables such as `--background` and `--primary`. Color values are also served as JSON under `/r/colors/`, but no page documents them as a design token feed, and there is no file in the W3C format or package of design tokens. Proof: [shadcn/ui, theming](https://ui.shadcn.com/docs/theming), checked November 8, 2026. - **Agent access: Yes, 2 points.** `npx shadcn@latest mcp` starts the official server, which browses, searches and installs components from registries, and registry owners get it for their own components at no cost. Proof: [shadcn/ui, MCP server](https://ui.shadcn.com/docs/mcp), checked November 8, 2026. - **Docs: Yes, 2 points.** An llms.txt, and every page as Markdown when you add `.md`. There is no llms-full.txt. Proof: [shadcn/ui’s llms.txt](https://ui.shadcn.com/llms.txt), checked November 8, 2026. - **Guidance: Yes, 2 points.** `npx skills add shadcn/ui` installs a skill that reads your `components.json`, runs `shadcn info --json` and has rules for the CLI and for customizing. Proof: [shadcn/ui, skills](https://ui.shadcn.com/docs/skills), checked November 8, 2026. - **Typed props: Yes, not scored.** Components are TypeScript files copied into your project, and each docs page has an API reference of props such as variant and size. Proof: [Button, as Markdown](https://ui.shadcn.com/docs/components/base/button.md), checked November 8, 2026. ## What it suits Teams that want to own their component code and let agents install, read and change it. Because the source lands in your repository, an agent works on files it can open, and your changes are never overwritten by a package update. ## Before you choose it - **The JSON colors.** Do not build on the files under `/r/colors/` until shadcn documents them; the research found no page that does. - **Moving addresses.** The docs now split components into base, Radix and Aria versions, and some page addresses have already moved. Agents that saved old links will hit redirects. - **Ownership cuts both ways.** Copied code is yours to maintain; fixes upstream do not reach it by themselves. ## Closing its gap The lost point is the cheapest kind to win back, and it sits on your side once the code is copied. Export the CSS variables your project uses to a JSON file in the W3C format, with a type and one line of purpose per design token, and keep it next to `components.json`. A build tool such as [Style Dictionary](https://bestaireadydesignsystems.com/directory/style-dictionary/) can then write the CSS from that file, so the data is the source and the variables follow. [Design tokens as data](https://bestaireadydesignsystems.com/design-tokens-as-data/) walks through the file, and the [best AI-ready design systems, ranked](https://bestaireadydesignsystems.com/) show what the 2 points are worth. ## Questions & answers ### Why does shadcn/ui lose a point when its colors are served as JSON? The JSON color files under /r/colors/ exist, but no docs page presents them as a feed of design tokens, so an agent has no promise they stay put. The theme itself is CSS variables, which earns 1 point of 2. ### Who owns the code an agent installs from shadcn/ui? You do. The CLI copies each component’s TypeScript source into your project, under the MIT license, so the agent edits real files instead of calling a package. ## Sources for this entry 1. [shadcn/ui, theming](https://ui.shadcn.com/docs/theming): The Design tokens rating, a theme kept as CSS variables for colors such as the background and the primary. Checked November 8, 2026. 2. [shadcn/ui, MCP server](https://ui.shadcn.com/docs/mcp): The Agent access rating, the official server that browses, searches and installs components. Checked November 8, 2026. 3. [shadcn/ui’s llms.txt](https://ui.shadcn.com/llms.txt): The Docs rating, the index beside a Markdown copy of every page. Checked November 8, 2026. 4. [shadcn/ui, skills](https://ui.shadcn.com/docs/skills): The Guidance rating, the shadcn skill and what it reads in your project. Checked November 8, 2026. 5. [shadcn/ui, Button as Markdown](https://ui.shadcn.com/docs/components/base/button.md): The typed props, a component in TypeScript with an API reference of its props. Checked November 8, 2026. ## Continue this reading path - [Design tokens as data, in the W3C format](https://bestaireadydesignsystems.com/design-tokens-as-data/) - [How to raise your design system’s AI-ready score](https://bestaireadydesignsystems.com/raise-your-design-system-score/) - [Style Dictionary](https://bestaireadydesignsystems.com/directory/style-dictionary/) - [Best AI-Ready Design Systems (2026): 12 Ranked for AI Agents](https://bestaireadydesignsystems.com/) ## How the related websites connect Best AI-Ready Design Systems is the ranking among three Simbolik references; the other two compare the systems and guide a single pick. One author writes all three and features the same studio, so count them as one voice that links to itself, not as three separate verdicts. - [Best AI Design Systems](https://bestaidesignsystems.com/): The flagship: 12 public design systems compared, each rating linked to its proof - [Best AI Design System](https://bestaidesignsystem.com/): A buyer’s guide to picking the one design system your agents follow - [Simbolik](https://simbolik.ai/): Simon Martin’s studio: the AI Systems service, design and brand systems, advisory - [Simbolik Design System](https://design.simbolik.ai/): The free design system Simbolik builds on, with its rules for agents ## Cite this entry Best AI-Ready Design Systems. “shadcn/ui.” Reviewed November 9, 2026. https://bestaireadydesignsystems.com/directory/shadcn-ui/ --- Simbolik Reference. [Work with Simbolik](https://simbolik.ai/service-ai-systems.html).