Basislinie UI
Erzwingt eine meinungsstarke UI-Basislinie, um KI-generierten Interface-Schrott zu verhindern.
Verwendung
-
/baseline-uiWendet diese Einschränkungen auf alle UI-Arbeiten in dieser Konversation an. -
/baseline-ui <datei>Überprüft die Datei auf alle untenstehenden Einschränkungen und gibt aus:- Verstöße (zitiere die genaue Zeile/den Ausschnitt)
- warum es wichtig ist (1 kurzer Satz)
- eine konkrete Korrektur (Code-Vorschlag auf Code-Ebene)
Stack
- MUSS Tailwind CSS-Standardwerte verwenden, es sei denn, benutzerdefinierte Werte existieren bereits oder werden explizit angefordert
- MUSS
motion/react(ehemalsframer-motion) verwenden, wenn JavaScript-Animation erforderlich ist - SOLLTE
tw-animate-cssfür Eingangs- und Mikroanimationen in Tailwind CSS verwenden - MUSS das
cn-Hilfsprogramm (clsx+tailwind-merge) für Klassenlogik verwenden
Komponenten
- MUSS zugängliche Komponenten-Primitive für alles mit Tastatur- oder Fokusverhalten verwenden (
Base UI,React Aria,Radix) - MUSS zuerst die vorhandenen Komponenten-Primitive des Projekts verwenden
- NIEMALS Primitive-Systeme innerhalb derselben Interaktionsfläche mischen
- SOLLTE
Base UIfür neue Primitive bevorzugen, wenn es mit dem Stack kompatibel ist - MUSS ein
aria-labelzu reinen Icon-Buttons hinzufügen - NIEMALS Tastatur- oder Fokusverhalten von Hand nachbauen, es sei denn, es wird explizit angefordert
Interaktion
- MUSS einen
AlertDialogfür destruktive oder irreversible Aktionen verwenden - SOLLTE strukturelle Skelette für Ladezustände verwenden
- NIEMALS
h-screenverwenden,h-dvhverwenden - MUSS
safe-area-insetfür fixierte Elemente beachten - MUSS Fehler neben der Stelle anzeigen, wo die Aktion stattfindet
- NIEMALS Einfügen in
input- odertextarea-Elementen blockieren
Animation
- NIEMALS Animation hinzufügen, es sei denn, sie wird explizit angefordert
- MUSS nur Compositor-Properties (
transform,opacity) animieren - NIEMALS Layout-Properties (
width,height,top,left,margin,padding) animieren - SOLLTE das Animieren von Paint-Properties (
background,color) vermeiden, außer für kleine, lokale UI-Elemente (Text, Icons) - SOLLTE
ease-outfür Eingänge verwenden - NIEMALS
200msfür Interaktionsfeedback überschreiten - MUSS Endlosschleifen-Animationen anhalten, wenn sie nicht im sichtbaren Bereich sind
- SOLLTE
prefers-reduced-motionbeachten - NIEMALS benutzerdefinierte Easing-Kurven einführen, es sei denn, sie werden explizit angefordert
- SOLLTE das Animieren großer Bilder oder vollflächiger Oberflächen vermeiden
Typografie
- MUSS
text-balancefür Überschriften undtext-prettyfür Fließtext/Absätze verwenden - MUSS
tabular-numsfür Daten verwenden - SOLLTE
truncateoderline-clampfür dichte UI verwenden - NIEMALS
letter-spacing(tracking-*) ändern, es sei denn, es wird explizit angefordert
Layout
- MUSS eine feste
z-index-Skala verwenden (keine willkürlichenz-*) - SOLLTE
size-*für quadratische Elemente anstelle vonw-*+h-*verwenden
Performance
- NIEMALS große
blur()- oderbackdrop-filter-Oberflächen animieren - NIEMALS
will-changeaußerhalb einer aktiven Animation anwenden - NIEMALS
useEffectfür etwas verwenden, das als Renderlogik ausgedrückt werden kann
Design
- NIEMALS Verläufe verwenden, es sei denn, sie werden explizit angefordert
- NIEMALS violette oder mehrfarbige Verläufe verwenden
- NIEMALS Glüheffekte als primäre Hinweise verwenden
- SOLLTE die Tailwind CSS-Standardschattenskala verwenden, es sei denn, eine andere wird explizit angefordert
- MUSS leeren Zuständen eine klare nächste Aktion geben
- SOLLTE die Verwendung von Akzentfarben auf eine pro Ansicht beschränken
- SOLLTE vorhandene Theme- oder Tailwind CSS-Farbtokens verwenden, bevor neue eingeführt werden