O que é shadcn/ui?
shadcn/ui não é um pacote que você importa. A CLI copia o código-fonte de cada componente para o seu projeto, onde ele passa a ser seu e você o edita, e a mesma CLI traz itens de registries de terceiros e privados. Os componentes se apoiam em Radix, Base UI ou React Aria e usam Tailwind para os estilos; há guias de instalação para Next.js, Vite, Laravel, React Router, Astro e TanStack Start.
O repositório também traz agent skills: pastas com um SKILL.md que um agente de programação carrega quando a tarefa pede. O skill principal, shadcn, lê o seu components.json por meio de `shadcn info --json` e passa ao agente o seu framework, a versão do Tailwind, os aliases, a biblioteca de ícones, a biblioteca base e os componentes instalados, além de regras para combiná-los. Um segundo skill, migrate-radix-to-base, migra um projeto de Radix para Base UI. Você os instala com a CLI skills da Vercel: `npx skills add shadcn/ui`.
O repositório foi criado em janeiro de 2023 e tem cerca de 128.470 estrelas e 11.417 forks. A versão mais recente da CLI é shadcn@4.23.0 (27 de outubro de 2026), e o commit mais recente chegou em 17 de novembro de 2026.
shadcn/ui vale a pena?
O skill importa mais do que parece, porque shadcn/ui é a biblioteca que os agentes de programação já escolhem e a que eles mais erram nos detalhes. Um agente que escreve a partir dos dados de treinamento empilha campos de formulário em um div com space-y-4, sobrescreve cores com bg-blue-500 e esquece o DialogTitle de que os leitores de tela precisam. O skill shadcn é um regulamento escrito contra exatamente esses hábitos: formulários vão em FieldGroup e Field, grupos de 2 a 7 opções usam ToggleGroup, cores vêm de tokens semânticos e todo Dialog, Sheet e Drawer recebe um título. Cada regra aponta para um arquivo com pares de código incorreto e correto.
A outra metade é o contexto do projeto. Quando o skill carrega, ele executa `shadcn info --json` e entrega ao agente a sua configuração real, inclusive se o projeto usa Radix, Base UI ou React Aria, o que muda a API dos triggers personalizados. Depois, ele direciona o agente para `shadcn search`, `shadcn docs` e `add --diff` antes de escrever qualquer coisa à mão, e manda perguntar qual registry usar em vez de adivinhar. O skill tem um arquivo de evals com 8 prompts de teste, mais disciplina do que a maioria dos skills da comunidade mostra.
A instalação é um único comando, `npx skills add shadcn/ui`, executado no seu projeto. A CLI skills da Vercel detecta quais agentes você tem (ela cita Claude Code, Codex, Cursor, OpenCode e mais 75) e pergunta onde colocar os arquivos; adicione -g para instalar em todos os projetos. No skills.sh, o skill shadcn mostra cerca de 152.400 instalações e o de migração cerca de 38.500. A documentação descreve a experiência no Claude Code; o repositório também traz um pequeno agents/openai.yml para que o skill apareça com nome e ícone no Codex. O servidor MCP, separado, é configurado com `npx shadcn@latest mcp init --client claude` (ou cursor, vscode, codex, opencode) e permite que o agente navegue por registries e instale itens deles; o skill também ensina a usar esse servidor.
A concessão de segurança é específica. O skill aprova de antemão comandos de shell que rodam `shadcn@latest` via npx, pnpm dlx ou bunx, então no Claude Code o agente pode executar a CLI, incluindo add, sem perguntar, e @latest significa a versão que o npm estiver servindo naquele dia. Componentes de registries da comunidade chegam como código-fonte na sua árvore; o skill manda o agente lê-los depois, o que é um conselho, não uma verificação. A CLI skills envia telemetria anônima de instalação, a menos que você defina DISABLE_TELEMETRY=1.
Como biblioteca, o modelo se sustenta depois de quase quatro anos: você ganha código legível e nenhum aprisionamento, e paga com manutenção, porque componentes copiados não se atualizam sozinhos. As 1.746 issues e pull requests abertas mostram quanto movimento o projeto tem. Para um time React que usa agentes, o skill custa pouco para adicionar e corrige os erros que os agentes mais cometem neste código; para quem não usa shadcn/ui, ele não faz nada.
Onde ele se destaca
Um fundador solo construindo um painel SaaS em Next.js com Claude Code
Ter uma página de configurações e uma tabela de dados consistentes sem corrigir cada formulário à mão
Rode `npx skills add shadcn/ui` uma vez e peça a página. O agente lê a configuração do projeto, adiciona Tabs, Card e componentes de formulário pela CLI e segue as regras de FieldGroup. Sem custo além do uso normal do modelo.
Uma líder de front-end em um time de produto de 20 pessoas com um registry interno de componentes
Fazer os agentes usarem nossos componentes de marca em vez de inventar novos
Adicione o registry privado ao components.json com as variáveis de autenticação em .env.local, instale o skill e o servidor MCP, e os agentes buscam no registry antes de escrever marcação. A regra do skill de perguntar qual registry usar impede que eles recorram por padrão a itens públicos.
Um time com um projeto shadcn/ui antigo baseado em Radix
Migrar para Base UI sem quebrar o build
O skill migrate-radix-to-base confere a biblioteca base com `shadcn info`, exige uma árvore git limpa, roda primeiro o seu typecheck e migra um componente por commit, mantendo o Radix instalado até o último sair.
Antes de decidir
- Configuração
- Inicie um projeto com `npx shadcn@latest init` (ou um template) e depois rode `npx skills add shadcn/ui` na raiz do projeto; a CLI skills exige Node.js 22.20 ou mais recente. Servidor MCP opcional: `npx shadcn@latest mcp init --client <agent>`; no Codex é preciso editar o config.toml à mão.
- Integrações
- Os skills são instalados pela CLI skills da Vercel para Claude Code, Codex, Cursor, OpenCode e outros agentes. Servidor MCP para Claude Code, Cursor, VS Code com Copilot, Codex e OpenCode. Registries: o oficial, os da comunidade e privados com autenticação.
- Dados e privacidade
- Uma biblioteca de front-end sem serviço hospedado. O skill executa a CLI do shadcn localmente; a CLI skills envia telemetria anônima de instalação (DISABLE_TELEMETRY=1 ou DO_NOT_TRACK=1 desativa). Os tokens de registries privados ficam no seu .env.local.
- Custo em escala
- Gratuito em qualquer escala. O custo real é manter os componentes copiados e o contexto que o skill acrescenta a cada carregamento; o consumo de tokens por carregamento não é publicado.
- Limites
- Só React, pensado para Tailwind. O skill é acionado por um arquivo components.json, então não faz nada em projetos sem ele. A documentação mostra o fluxo no Claude Code; como outros agentes tratam o comando `shadcn info` embutido no skill não está documentado.
O que é bom
- O código dos componentes fica no seu repositório, sem dependência em tempo de execução para contornar
- O skill lê a configuração real do projeto antes de o agente escrever código
- Regras de composição concretas com exemplos incorretos e corretos
- Um único comando de instalação cobre Claude Code, Codex, Cursor e dezenas de outros agentes
- Licença MIT; skills, CLI e servidor MCP são gratuitos
O que não é
- O skill aprova de antemão comandos `npx shadcn@latest` sem versão fixa
- Componentes copiados precisam de atualização manual
- Código de registries de terceiros só é revisado pelo agente, quando é
- Só React e Tailwind
Ideal para
Times de React e Tailwind que deixam agentes de programação construir a interface e querem que o resultado siga as convenções do shadcn/ui.
Alternativas ao shadcn/ui
shadcn/ui: perguntas frequentes
- shadcn/ui vale a pena?
- Continua sendo o caminho padrão para dar a um app React uma camada de componentes que é sua, e o skill para agentes é o exemplo mais claro até agora de uma biblioteca ensinando as próprias regras aos agentes de programação. Damos nota 4.5 de 5.
- Quanto custa shadcn/ui?
- Gratuito sob a licença MIT; sem plano pago. Os skills também são gratuitos.
- Quais são as desvantagens de shadcn/ui?
- O skill aprova de antemão comandos `npx shadcn@latest` sem versão fixa; componentes copiados precisam de atualização manual; código de registries de terceiros só é revisado pelo agente, quando é; só React e Tailwind.
- Para quem shadcn/ui é indicado?
- Times de React e Tailwind que deixam agentes de programação construir a interface e querem que o resultado siga as convenções do shadcn/ui.
- Quanto custa shadcn/ui para uma equipe ou em produção?
- Gratuito em qualquer escala. O custo real é manter os componentes copiados e o contexto que o skill acrescenta a cada carregamento; o consumo de tokens por carregamento não é publicado.
- shadcn/ui é seguro para dados da empresa?
- Uma biblioteca de front-end sem serviço hospedado. O skill executa a CLI do shadcn localmente; a CLI skills envia telemetria anônima de instalação (DISABLE_TELEMETRY=1 ou DO_NOT_TRACK=1 desativa). Os tokens de registries privados ficam no seu .env.local.
- Quais são as melhores alternativas ao shadcn/ui?
- As alternativas mais próximas que analisamos são Astryx, Impeccable e Anthropic Skills.
Respostas verificadas em 18 de nov. de 2026.