Skill: animate-ui
Aktivierungsvertrag
Verwende dieses Skill, wenn:
- Du animierte UI-Komponenten mit der Animate UI Distribution hinzufügst oder anpasst.
- Du Motion-betriebene (Framer Motion) Muster in einem shadcn/ui-Projekt implementierst.
- Du das Animate UI Registry einrichtest oder spezifische Primitive/Komponenten hinzufügst.
Harte Regeln
- Copy-First-Ansatz: Behandle Komponenten immer als „offenen Code“, der kopiert und modifiziert werden kann, nicht als feste Bibliotheksimporte.
- Abhängigkeitsprüfung: Stelle sicher, dass
motion,tailwind-merge,clsxundlucide-reactinstalliert sind, bevor du Komponenten hinzufügst. - Namenskonvention: Folge dem
@animate-ui/{kategorie}-{unterkategorie}-{name}-Muster für shadcn CLI-Befehle. - Importpfade: Verwende standardmäßig
@/components/animate-ui/für alle hinzugefügten Komponenten und Primitive. - Standard-Stack: Verwende React, Tailwind CSS und Framer Motion (Motion).
Entscheidungsgates
| Aufgabe | Aktion |
|---|---|
| Neues Projekt | Führe npx shadcn@latest init aus, dann konfiguriere Tailwind/Motion. |
| Primitive hinzufügen | Verwende npx shadcn@latest add @animate-ui/primitives-{kategorie}-{name}. |
| Komponente hinzufügen | Verwende npx shadcn@latest add @animate-ui/components-{kategorie}-{name}. |
| Benutzerdefinierte Motion | Erweitere bestehende Komponenten mit motion-Props (z. B. whileHover, transition). |
Ausführungsschritte
- Voraussetzungen prüfen: Überprüfe, ob
framer-motion(odermotion) undtailwind-mergein derpackage.jsonvorhanden sind. - Initiale Einrichtung: Falls noch nicht geschehen, führe den
shadcn/ui-Initialisierungsprozess durch. - Komponentenauswahl: Entscheide, ob du ein Primitive (Logik + grundlegende Bewegung) oder eine Komponente (gestyltes UI-Element) benötigst.
- Installation: Verwende die shadcn CLI mit den
@animate-ui-Paketnamen. - Integration: Importiere aus
@/components/animate-ui/...und übergib die erforderlichen Props. - Verfeinerung: Passe die Federübergänge (Steifigkeit, Dämpfung) an, um sie an das Projektgefühl anzupassen.
Ausgabevertrag
- Liste der über die shadcn CLI hinzugefügten Komponenten.
- Überprüfte Importpfade in der Implementierung.
- Erklärung der angepassten Motion-Einstellungen, falls vorhanden.
Referenzen
references/getting-started.md— Installations- und Einrichtungsanleitung.references/components.md— Kategorien und Namenskonventionen.references/motion-patterns.md— Übliche Feder- und Übergangseinstellungen.