Imported from promovaweb/specsfy (
specialists/specsfy-specialist-tailwind-css/SKILL.md). Install upstream withnpx skills add promovaweb/specsfy --skill specsfy-specialist-tailwind-css. Copyright stays with the author.
Tailwind CSS
Quando usar
- Acionar quando o projeto depende de
tailwindcsse a tarefa envolve classe utilitária, tema, variante, responsividade ou dark mode. - Acionar também para decidir se um padrão visual repetido deve virar token,
@applylocal ou componente extraído, ou se um utilitário novo da versão instalada (scrollbar, container de tamanho, zoom, tab-size) resolve sem CSS próprio. - Não acionar para a escolha da biblioteca de componentes em si (Radix,
shadcn/ui); usar
$specsfy-specialist-ui-componentspara isso e voltar aqui para o sistema de tokens e classes que a sustenta. - Combinar com
$specsfy-specialist-interfacepara contraste, zoom eprefers-reduced-motion.
No Specsfy
-
Fonte de entrada por fase
- Em
specsfy-02-backlog, leia o item emspecs/backlog/e registre ali as decisões e sinais do especialista, além das dúvidas abertas. - Em
specsfy-03-specifyespecsfy-04-validate, use a spec aberta e devolva a conclusão à seção trabalhada pela fase. - Em
specsfy-05-tasks, ajude a sugerir e sincronizar especialistas e modos entre o cabeçalho, a seção 8 e as tarefas. Só essa fase escreve a seção 14. - Em
specsfy-06-implement, limite-se à tarefa indicada e ao passo carregado.
Nas fases com spec, leia a spec aberta indicada pela skill chamadora ou localizada por
specsfy status. Consulte a linha| Especialistas |, a subseção#### Especialistasem### 8. Plano técnicoe a seção pertinente à fase. Leia também.specsfy/STACK.md,.specsfy/RULES.mde, para tokens e telas em uso,INTERFACE.md. - Em
-
Siga o modo indicado na spec ou na tarefa, no formato
Especialista: $specsfy-specialist-tailwind-css. Sem indicação, confirme pelo "Quando usar" acima a versão instalada antes de propor sintaxe. -
Devolva a conclusão e as dúvidas abertas no destino indicado no item 1, no próprio backlog, na spec ou na tarefa da fase.
-
Não mude o estado da spec nem marque gate: isso pertence a
$specsfy-03-specify,$specsfy-04-validate,$specsfy-05-taskse$specsfy-06-implement. -
Mapeie cada token ou classe nova para a tela e o estado descritos em
INTERFACE.mde, quando a fase trabalhar o plano técnico da spec, registre na seção 8 a escolha entre utilitário,@applye componente extraído.
Fluxo
- Confirmar a versão do Tailwind, a integração (Vite, PostCSS, webpack ou
framework) e onde os tokens são declarados (
tailwind.config.jsou@themeem CSS na v4): a sintaxe de configuração muda entre gerações. Na v4.3, a integração usa@tailwindcss/vite,@tailwindcss/postcssou@tailwindcss/webpack, e o CLI é@tailwindcss/cli. - Traduzir o layout e os estados da interface em constraints responsivas
(breakpoints ou
@container) antes de escrever a primeira classe. - Reutilizar tokens semânticos já existentes (cor, espaçamento, radius,
tipografia) antes de recorrer a valor arbitrário (
w-[137px]). - Implementar mobile-first: escrever o estilo base para a tela menor e sobrepor apenas o que muda nos breakpoints maiores.
- Cobrir estados interativos (
hover,focus-visible,disabled,aria-*) e preferências do usuário (dark,motion-reduce,forced-colors) desde a primeira versão do componente, não como retrofit. - Extrair um componente (não
@apply) quando o padrão repetido representa uma unidade semântica reconhecível (um "Card", um "Badge"), não apenas uma coincidência visual entre dois lugares. - Validar o CSS gerado no build de produção: nenhuma classe usada dinamicamente deve estar ausente por não ser detectável estaticamente pelo scanner de conteúdo.
Padrões
- Manter cor, espaçamento, radius e tipografia como tokens com nome de
intenção (
bg-surface,text-muted) sempre que o projeto já tiver um sistema de design, não introduzir valor solto que dribla o token existente. - Expressar estado (hover, foco, seleção, erro) com variantes do próprio
Tailwind (
hover:,aria-selected:,data-[state=open]:), nunca escondendo a lógica de estado em concatenação de string opaca fora da vista do build. - Não usar
@applycomo substituto geral de componente: ele recria uma folha de estilo tradicional dentro do utility-first e perde a colocação (a classe deixa de estar ao lado do elemento que ela estiliza). (regra da casa) - Garantir que toda classe construída dinamicamente (template string,
concatenação condicional) seja detectável estaticamente pelo scanner de
conteúdo: usar mapas completos de classes literais em vez de montar a
classe por concatenação de partes (
text-${color}-500não funciona: o scanner não executa o template). - Tratar dark mode,
prefers-reduced-motion,prefers-contrasteforced-colorscomo requisito de design, não como camada opcional adicionada depois. - Preferir layout fluido (
flex,grid, unidades relativas) e@containerquando o componente precisa responder ao próprio contêiner (ex.: um card que muda de layout dentro de uma sidebar estreita), não ao viewport inteiro. Na v4.3,@container-sizecobre o caso em que a consulta depende também da altura (cqb/cqh). - Usar propriedades lógicas (
ms-,me-,pbs-,pbe-,inline-*,block-*,inset-s-*,inset-e-*) quando o layout precisa sobreviver a RTL ou modo de escrita vertical;start-*eend-*estão depreciados na v4.2 em favor deinset-s-*einset-e-*. - Preferir o utilitário de primeira parte da versão instalada antes de CSS
customizado:
scrollbar-*escrollbar-gutter-*(v4.3),zoom-*(v4.3),tab-*(v4.3),font-features-*(v4.2) e as paletasmauve,olive,mistetaupe(v4.2). - Não multiplicar valores arbitrários (
p-[13px],text-[15px]) sem antes perguntar se um novo token de escala deveria existir: um valor arbitrário isolado é aceitável; vários próximos e repetidos indicam token ausente.
Antipadrões
- Classe montada por concatenação de variável (
`bg-${color}-500`): o scanner de conteúdo do Tailwind não executa JS, então essa classe nunca é gerada no CSS final; use um mapa literal de classes completas. @applyusado para recriar dezenas de componentes CSS tradicionais: perde a vantagem de colocation do utility-first e cria uma folha de estilo paralela difícil de rastrear.- Cor, espaçamento ou radius hardcoded (
#3b82f6,17px) ao lado de um sistema de tokens já existente: quebra o tema (claro/escuro, marca) na primeira mudança centralizada. - Adicionar dark mode, foco visível ou movimento reduzido só depois de uma reclamação de acessibilidade, em vez de tratá-los como parte do componente desde a primeira versão.
- Confundir a responsabilidade desta skill com a escolha de biblioteca de
componentes prontos: Tailwind é a camada de utilitários/tema; a escolha
de "qual Data Table usar" pertence a
$specsfy-specialist-ui-components.
Validação
- Rodar o build de produção e inspecionar se alguma classe esperada está ausente do CSS final (sinal de classe não detectável estaticamente).
- Testar em viewports pequenos e grandes, com container real quando o
componente usar
@container, em zoom 200% e 400% (reflow a 320px de largura equivalente), sem perda de conteúdo ou scroll horizontal indesejado. - Percorrer
hover,focus-visible,disabled,loading,erroreselectedvisualmente e por teclado. - Checar contraste nos temas claro e escuro. Checar também o comportamento com
prefers-reduced-motion/forced-colorsativados no sistema operacional. - Não declarar um componente "responsivo" ou "acessível" apenas por ter
classes
sm:/dark:presentes; a comprovação acima é obrigatória antes da afirmação.
Skills relacionadas
$specsfy-specialist-ui-componentsmantém as composições React e Tailwind do catálogo gratuito e o sistema de componentes construído sobre Tailwind + Radix; este especialista cobre o token e o utilitário que o sustenta.$specsfy-specialist-interfaceescolhe e compõe a página e aprofunda contraste, zoom, reflow eprefers-reduced-motion.$specsfy-specialist-reacte$specsfy-specialist-nextjsfornecem o componente/framework onde as classes Tailwind são aplicadas; esta skill não decide estrutura de componente nem fronteira server/client.$specsfy-specialist-typescripttipa variantescvaquando o projeto expõe props de estilo fortemente tipadas.
Leia references/standards.md para camadas de
tokens, variantes, @container, detecção de classes e migração entre
versões, com fontes oficiais.
