Documentation
How sites document components, design systems and style — for human readers and increasingly for coding agents.
Start here
- The Component Gallery — aggregates how 95 different design systems document the same components.
- shadcn/ui —
llms.txtand an MCP registry published alongside human-facing docs. - DESIGN.md — a whole design system distributed as a single markdown file.
- Refero Styles — real brand styles extracted into AI-readable
DESIGN.mdfiles. - Carbon Design System — a large system documented well for both audiences: tabbed component pages for people and a clean
llms.txtindex for agents.
All sources
Ship: reuse with the notice or credit the licence asks forConditional: read the terms before you reuse anythingLook only: no licence stated, so take ideas and nothing else
- Adobe SpectrumAdobe's Spectrum design system pairs visual foundations, components and patterns with separate open-source implementations.Verdict Very usefulConditional licence, mixedAgent channels noneReviewed
- Ahmad ShadeedHands-on CSS layout articles and an interactive lab for inspecting modern selectors, grids and container queries.Verdict UsefulLook only licence, not statedAgent channels noneReviewed
- Angular NativeAlpha MIT framework for building native iOS and Android apps with Angular, Expo and React Native's rendering layer.Verdict NicheShip licence, open source permissiveAgent channels llms-txtReviewed
- Anime.jsJavaScript animation engine with fine-grained control over complex sequences and SVG effects, and a clear, well-documented API.Verdict UsefulShip licence, open source permissiveAgent channels noneReviewed
- Anthropic Design PluginAnthropic's Apache-2.0 designer plugin: structured critique, UX copy, WCAG review and handoff templates.Verdict UsefulShip licence, open source permissiveAgent channels skillReviewed
- AstryxMeta's React design system with rich form controls, strong accessibility hooks and a plugin-based table.Verdict Very usefulShip licence, open source permissiveAgent channels cliReviewed
- Base UIUnstyled, accessible React primitives from the Radix, Floating UI and MUI teams, now shadcn's default.Verdict Very usefulShip licence, open source permissiveAgent channels llms-txtReviewed
- Carbon Design SystemIBM's Apache-2.0 system: about 50 components, 2,775 icons and 1,576 pictograms, llms.txt, and an IBMid-gated MCP.Verdict Very usefulShip licence, open source permissiveAgent channels mcp, llms-txt, skillReviewed
- Design System Checklist230 items across language, foundations, 29 components and maintenance, with shareable progress links.Verdict UsefulLook only licence, not statedAgent channels noneReviewed
- DESIGN.mdCommunity library of whole design systems as single markdown files, with light/dark previews, an MCP server and a CLI.Verdict Very usefulLook only licence, not statedAgent channels mcp, cliReviewed
- Design.md Store51 free brand-inspired DESIGN.md packs plus clear docs on the Google DESIGN.md format; strict reuse terms.Verdict UsefulConditional licence, proprietary paidAgent channels llms-txtReviewed
- Designer Skills111 small design-practice skills in nine plugins, with a router that picks one entry point.Verdict UsefulShip licence, open source permissiveAgent channels skillReviewed
- Devouring DetailsRauno Freiberg's paid interactive manual on interaction craft, with 23 chapters and downloadable React prototypes.Verdict Very usefulLook only licence, not statedAgent channels noneReviewed
- DialKitMIT live control panel for tuning springs, easing, layout and timelines in React, Vue, Svelte, Solid and plain JS.Verdict Very usefulShip licence, open source permissiveAgent channels llms-txt, promptsReviewed
- Every LayoutIntrinsic CSS layout primitives with free visual examples, interactive demos and configurable generators.Verdict UsefulConditional licence, proprietary paidAgent channels noneReviewed
- GPUI KitA Rust desktop UI framework showcase with component examples, theme controls, docking, data tables and application stories.Verdict UsefulConditional licence, mixedAgent channels llms-txtReviewed
- IBM Design Language colorIBM's color reference shows palette families, accepted gradients, UI themes, accessibility rules and examples in use.Verdict UsefulLook only licence, not statedAgent channels noneReviewed
- Inclusive ComponentsHeydon Pickering's 11 in-depth posts on making common components accessible, each ending in a checklist.Verdict Very usefulLook only licence, not statedAgent channels noneReviewed
- Josh W. ComeauInteractive CSS guides where you can resize layouts, change rules and inspect the resulting interface.Verdict UsefulLook only licence, not statedAgent channels noneReviewed
- Laws of UX30 psychology principles with takeaways and origins, served as llms.txt and markdown; CC BY-NC-ND.Verdict Very usefulConditional licence, cc noncommercialAgent channels llms-txtReviewed
- Modern CSS SolutionsPractical CSS references with rendered examples for responsive layouts, components, typography and interaction states.Verdict UsefulLook only licence, not statedAgent channels noneReviewed
- MorphrigInteractive manual on how SVG icon morphing works, with measured browser findings and llms-full.txt.Verdict UsefulLook only licence, not statedAgent channels llms-txtReviewed
- No AI SlopRemoves AI writing patterns while keeping the writer's voice, and has a detect-only mode.Verdict UsefulShip licence, open source permissiveAgent channels skillReviewed
- Open UICross-system component research that maps names, visual states and behavior differences for common web controls.Verdict NicheConditional licence, mixedAgent channels noneReviewed
- RadixWorkOS-maintained primitives, Themes, 15px icons and the 12-step Radix Colors system.Verdict Very usefulShip licence, open source permissiveAgent channels llms-txtReviewed
- Refero Styles2,000+ real brand styles extracted into agent-readable DESIGN.md files, searchable by mood, with an MCP connection.Verdict Very usefulLook only licence, not statedAgent channels mcpReviewed
- Shadcn LabsIndex of the independent Shadcn Labs registries: termcn, pdfcn, emailcn, ogimagecn, shadercn and more.Verdict UsefulShip licence, open source permissiveAgent channels noneReviewed
- shadcn/uiAccessible React components copied into your repo and edited freely, with llms.txt, a CLI and an MCP registry.Verdict Very usefulShip licence, open source permissiveAgent channels mcp, llms-txt, cli, registry, skillReviewed
- shieldcnshadcn-styled README badges, charts and headers from 45+ providers, with a README builder and agent skill.Verdict UsefulShip licence, open source permissiveAgent channels llms-txt, registry, skillReviewed
- startercnMIT Next.js template for publishing your own shadcn registry, with Fumadocs docs, llms.txt and skill discovery.Verdict UsefulShip licence, open source permissiveAgent channels llms-txt, api, skillReviewed
- Stop SlopSmall prose skill listing AI phrases and sentence shapes to cut, with a 50-point score.Verdict UsefulShip licence, open source permissiveAgent channels skillReviewed
- The Book of ShadersClassic step-by-step guide to fragment shaders with editable live examples; learning only, all rights reserved.Verdict Very usefulConditional licence, proprietary freeAgent channels noneReviewed
- The Component GalleryReference that compares how 95 design systems name, structure and document the same 60 components.Verdict Very usefulLook only licence, not statedAgent channels noneReviewed
- UI Playbook (stale)Rauno Freiberg's nine component "plays" listing the states, traps and ARIA rules each one needs.Verdict UsefulStaleShip licence, open source permissiveAgent channels noneReviewed
- UIAble790+ components, 390+ blocks and templates built on shadcn/ui and Base UI, with command-palette-searchable docs.Verdict Very usefulConditional licence, mixedAgent channels noneReviewed
- visualize (display.dev)Brand-aware HTML reports, decks and dashboards, checked by named bans and deterministic detectors.Verdict Very usefulShip licence, open source permissiveAgent channels skillReviewed
Patterns worth reusing
- Publish an
llms.txtor markdown index alongside human docs so agents can parse the catalog directly, without scraping HTML. - Distribute an entire design system as one markdown file an agent can treat as source of truth for style.
- Tag each documented entry with badges (accessibility, code examples, unmaintained) for an at-a-glance trust signal.
- Link out to the original system's documentation instead of duplicating anatomy and guidance content.
- Serve component docs at predictable URLs (e.g.
/r/<name>.md) so an agent can fetch exactly the page it needs. - Offer a Human/Agent toggle on the docs: the agent view states purpose, workflow and install snippets in plain Markdown, with ready prompts next to it (DialKit).
- Document a spec format with best-practice pages on writing for AI, semantic token naming and versioning, not just a field reference (Design.md Store).
- Serve markdown from the same URLs through content negotiation (
Accept: text/markdown) instead of keeping a separate agent docs site, and say inllms.txtwhen the resource fits and when it doesn't (Laws of UX). - Document every component under the same headings so a missing state or accessibility note stands out (UI Playbook, Carbon Design System).
- Put a live, editable example or a scrubbable figure next to each concept, and publish the measurements behind any claim (The Book of Shaders, Morphrig).
- End each component page with a short checklist a reviewer can tick off (Inclusive Components).
- Export README images as light and dark
<picture>pairs so they follow the reader's theme (shieldcn).
Pitfalls
- Aggregators are only a gateway: detailed anatomy and guidance still live on the original system's site, not inline.
- Community-submitted documentation varies in freshness; some catalogued systems are explicitly flagged "unmaintained."
- No licence is stated for many community-submitted design systems — verify before using one on a commercial project.
- Terms can forbid automated retrieval even when robots.txt allows AI crawlers; read both before pointing an agent at a docs site (Design.md Store).
- Free to read is not free to reuse: The Book of Shaders reserves all rights, Laws of UX forbids derivatives and commercial use, and Morphrig states no licence at all.
- Good docs date too: UI Playbook was last pushed in January 2023 and Inclusive Components in 2018, so check examples against current standards.
- Some docs only render in the browser; point agents at the repo sources instead (Design System Checklist's
src/translations/en/*.js, UI Playbook's MDX files).