Compétence : animate-ui
Contrat d'activation
Utilisez cette compétence lorsque :
- Vous ajoutez ou personnalisez des composants d'interface utilisateur animés en utilisant la distribution Animate UI.
- Vous implémentez des modèles basés sur Motion (Framer Motion) dans un projet shadcn/ui.
- Vous configurez le registre Animate UI ou ajoutez des primitives/composants spécifiques.
Règles strictes
- Approche de copie d'abord : Traitez toujours les composants comme du « code ouvert » à copier et modifier, et non comme des imports de bibliothèque fixes.
- Vérification des dépendances : Assurez-vous que
motion,tailwind-merge,clsxetlucide-reactsont installés avant d'ajouter des composants. - Convention de nommage : Suivez le modèle
@animate-ui/{catégorie}-{sous-catégorie}-{nom}pour les commandes CLI shadcn. - Chemins d'importation : Par défaut, utilisez
@/components/animate-ui/pour tous les composants et primitives ajoutés. - Stack standard : Utilisez React, Tailwind CSS et Framer Motion (Motion).
Portes de décision
| Tâche | Action |
|---|---|
| Nouveau projet | Exécutez npx shadcn@latest init puis configurez Tailwind/Motion. |
| Ajouter une primitive | Utilisez npx shadcn@latest add @animate-ui/primitives-{catégorie}-{nom}. |
| Ajouter un composant | Utilisez npx shadcn@latest add @animate-ui/components-{catégorie}-{nom}. |
| Motion personnalisé | Étendez les composants existants en utilisant les props motion (par exemple, whileHover, transition). |
Étapes d'exécution
- Vérifier les prérequis : Vérifiez si
framer-motion(oumotion) ettailwind-mergesont danspackage.json. - Configuration initiale : Si ce n'est pas déjà fait, suivez le processus d'initialisation de
shadcn/ui. - Sélection du composant : Identifiez si vous avez besoin d'une Primitive (logique + mouvement de base) ou d'un Composant (élément d'interface utilisateur stylisé).
- Installation : Utilisez la CLI shadcn avec les noms de packages sous la portée
@animate-ui. - Intégration : Importez depuis
@/components/animate-ui/...et passez les props nécessaires. - Polissage : Ajustez les transitions spring (raideur, amortissement) pour correspondre à l'ambiance du projet.
Contrat de sortie
- Liste des composants ajoutés via la CLI shadcn.
- Chemins d'importation vérifiés dans l'implémentation.
- Explication des ajustements Motion personnalisés, le cas échéant.
Références
references/getting-started.md— Guide d'installation et de configuration.references/components.md— Catégories et conventions de nommage.references/motion-patterns.md— Paramètres spring et de transition courants.