Skill: animate-ui
Contrato de Ativação
Use esta skill quando:
- Adicionar ou personalizar componentes de UI animados usando a distribuição Animate UI.
- Implementar padrões alimentados por Motion (Framer Motion) em um projeto shadcn/ui.
- Configurar o registro Animate UI ou adicionar primitivas/componentes específicos.
Regras Rígidas
- Abordagem de Cópia-Primeiro: Sempre trate os componentes como "código aberto" a ser copiado e modificado, não como importações fixas de biblioteca.
- Verificação de Dependências: Garanta que
motion,tailwind-merge,clsxelucide-reactestejam instalados antes de adicionar componentes. - Convenção de Nomenclatura: Siga o padrão
@animate-ui/{categoria}-{subcategoria}-{nome}para comandos CLI do shadcn. - Caminhos de Importação: Use como padrão
@/components/animate-ui/para todos os componentes e primitivas adicionados. - Stack Padrão: Use React, Tailwind CSS e Framer Motion (Motion).
Portões de Decisão
| Tarefa | Ação |
|---|---|
| Novo Projeto | Execute npx shadcn@latest init e configure Tailwind/Motion. |
| Adicionar Primitiva | Use npx shadcn@latest add @animate-ui/primitivas-{categoria}-{nome}. |
| Adicionar Componente | Use npx shadcn@latest add @animate-ui/componentes-{categoria}-{nome}. |
| Motion Personalizado | Estenda componentes existentes usando props motion (ex.: whileHover, transition). |
Etapas de Execução
- Verificar Pré-requisitos: Cheque se
framer-motion(oumotion) etailwind-mergeestão empackage.json. - Configuração Inicial: Se ainda não foi feito, siga o processo de inicialização do
shadcn/ui. - Seleção de Componente: Identifique se você precisa de uma Primitiva (lógica + movimento básico) ou de um Componente (peça de UI estilizada).
- Instalação: Use o CLI do shadcn com os nomes de pacotes com escopo
@animate-ui. - Integração: Importe de
@/components/animate-ui/...e passe as props necessárias. - Polimento: Ajuste as transições spring (stiffness, damping) para combinar com a sensação do projeto.
Contrato de Saída
- Lista de componentes adicionados via CLI do shadcn.
- Caminhos de importação verificados na implementação.
- Explicação de quaisquer ajustes de motion personalizados, se houver.
Referências
references/getting-started.md— Guia de instalação e configuração.references/components.md— Categorias e convenções de nomenclatura.references/motion-patterns.md— Configurações comuns de spring e transição.