shadcn-ui/lint

An agent-first linter for Tailwind design systems. Write design system rules that agents can verify.

Open original source ↗

Older snapshot: check the original source for current information.

From the publisher

README & documentation

Source preview

Read the project’s overview, installation instructions and usage examples. The original README is the source of truth.

Write design system rules that agents can verify. @shadcn/lint is an agent-first linter for Tailwind design systems. You define what’s allowed. When an agent breaks a rule, the error explains what’s wrong and suggests a fix based on your components, variants, and theme. Works with your existing design system. No rewrite required. @shadcn/lint works with Tailwind v4 projects (shadcn/ui not required). Available for both ESLint and Oxlint. Works with React, Svelte, and Vue. Give your coding agent this prompt: Once installed, choose your rules and configure what’s allowed in your design system. Prefer to configure it yourself? See Get started. Take a Button that allows margin and width, but controls its own padding. You can enforce that with types by limiting its style prop to Pick. The rule works. But this error only tells the agent that padding is not allowed. It doesn’t tell it how to size the Button.…

shadcn-ui/lint on GitHub A short preview, not the full document.

Read the full README ↗ · Preview checked 2026-10-29T23:40:21.931Z

Inside the original README — Document outline
  1. @shadcn/lint
  2. Table of contents
  3. Quickstart
  4. TypeScript vs @shadcn/lint
  5. You decide what can change
  6. Built for agents
  7. It works
  8. It is cheaper
  9. Why a linter?
  10. Programmable
  11. Custom messages
  12. Placeholders

Headings are captured from the source. Links open the publisher’s document, not a locally hosted copy.

Links from the README

References supplied by the publisher, not independently verified endorsements. Check the destination before downloading files or entering credentials.

Documentation belongs to its respective authors. Reported project/model license: MIT. A listing is not a grant of reuse or training rights. Confirm the document’s own terms at the source.

What this repository does

An agent-first linter for Tailwind design systems. Write design system rules that agents can verify.

Repository facts

Owner
shadcn-ui
Primary language
TypeScript
Stars
2,998
Forks
60
Open issues + pull requests
23
License
MIT
Archived
No
Default branch
main
Created
2026-09-02T11:51:38.000Z
Last push
2026-09-22T11:30:38.000Z

Topics and intended use

Owner-supplied topics: agents, ai, design, design-system, design-tools, shadcn, shadcn-ui, tailwindcss

Review the README for scope, installation, examples and limitations. We do not run repository code or certify it.

Evaluate before installing

Review licensing and dependencies, inspect recent commits and unresolved issues, and test in an isolated environment before production use. Stars and forks alone cannot answer these questions.

README and project files

Issues and maintenance discussion

Releases and changelog

Source and freshness

Source: GitHub. Metadata observed 2026-10-02T12:05:35.823Z. Daily imports are snapshots, not real-time monitoring.

Popularity and source listings do not establish security, suitability, licensing rights or benchmark performance.

Open original source

Related repositories

freeCodeCamp/freeCodeCamp

morluto/rea

openclaw/openclaw

nilbuild/developer-roadmap

deepseek-ai/deepseek-harness

anomalyco/opencode