LibreAI / Dev Tools / @shadcn/lint
// devtools · shadcn-ui/lint

@shadcn/lint

@shadcn/lint — an agent-first linter for Tailwind design systems: you define what is allowed, and errors explain the fix in terms of your components

★ 3.2k stars⑂ 65 forksMITupdated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

@shadcn/lint is an open-source dev tools project by shadcn-ui (shadcn-ui/lint on GitHub). It has 3,205 GitHub stars and 65 forks, is released under the MIT license, and was last updated on GitHub on 15 October 2026.

Repository
shadcn-ui/lint
GitHub stars
3,205
Forks
65
License
MIT
Last updated on GitHub
15 October 2026
Category
Dev Tools
Listing
Full install guide
// how it works

How it works

  1. Add the package

    Install @shadcn/lint as a dev dependency alongside ESLint (or Oxlint).

  2. Choose your rules

    Configure what your design system allows — component props, variants and theme tokens.

  3. Lint as you (and your agents) work

    Violations come back as explanations with suggested fixes drawn from your own components.

// features

Why people love it

Built for agents

Errors are written to be acted on by coding agents: the rule, the reason, and a concrete fix in your design system’s vocabulary.

No rewrite required

Works with your existing Tailwind v4 design system whether or not you use shadcn/ui.

ESLint and Oxlint

Official integrations for both linters, so it fits the toolchain you already run.

React, Svelte and Vue

Framework parsers are wired in for all three ecosystems.

Advertisement
// run it

Run it yourself

  1. Install with ESLint

    The standard setup for a React or Svelte project.

    npm install -D @shadcn/lint eslint @typescript-eslint/parser
    npx eslint .
  2. Or with Oxlint

    For Oxlint-based projects.

    npm install -D @shadcn/lint oxlint
    npx oxlint
  3. Agent-driven setup

    Give your coding agent this prompt, per the README quickstart.

    Read https://github.com/shadcn-ui/lint/blob/main/SETUP.md and set up @shadcn/lint in this project.
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains @shadcn/lint?

The shadcn-ui project — the team behind shadcn/ui.

Is it free?

Yes, MIT-licensed and published on npm.

Does it need a paid API key?

No — it runs locally as part of your lint step.

How does it compare to a well-known alternative?

TypeScript can restrict a style prop with types, but the error is generic. @shadcn/lint explains the design-system rule and proposes the fix using your components and variants.

How do I get started?

Install it with npm install -D @shadcn/lint plus ESLint or Oxlint, choose your rules, and run your linter — or let your agent do the setup from SETUP.md.

// keep exploring

Similar tools

Dev Tools

oh-my-claudecode

Teams-first multi-agent orchestration for Claude Code — parallel agents, team mode and tmux workers

★ 39.7k starsMIT
View guide →
Dev Tools

avibe

A local-first Agent OS — drive Claude Code, Codex and OpenCode from your browser.

★ 606 starsMIT
View guide →
Dev Tools

magic-mcp

It's like v0, but in your Cursor / Claude Code / Windsurf: search 10,000+ React/Tailwind components, generate new UI with AI, and publish your own — right fr…

★ 6.0k starsISC
View guide →
Dev Tools

cli-printing-press

Generates agent-first Go CLIs (plus MCP servers) for any API or website — with local SQLite sync built in

★ 4.8k starsMIT
View guide →
Dev Tools

kicad-happy

AI coding agent skills for KiCad electronics design. Works with Claude Code and OpenAI Codex. Analyze schematics, review PCB layouts, EMC pre-compliance, SPI…

★ 1.3k starsMIT
View guide →
Dev Tools

code-review-graph

Local-first code intelligence graph for MCP and CLI. Builds a persistent map of your codebase so AI coding tools read only what matters, with benchmarked con…

★ 31.9k starsMIT
View guide →
// alternatives

Alternatives in Dev Tools

The most-starred other Dev Tools projects in the LibreAI catalogue — the realistic shortlist if @shadcn/lint is not the right fit.

Get @shadcn/lint

Free and open — grab the source, star the repo, and start creating.