Was macht 21 Grams UI?
Ein Durchgang über bereits existierende UI. 21 Grams UI (das UI-Paket der 21 Grams Familie) gestaltet das Produkt nicht neu und bringt kein eigenes UI-Kit mit. Es entfernt die Anzeichen von KI-erstellter UI und wendet einen festgelegten Regelsatz durch die Komponenten und Tokens des Projekts an, sodass das Ergebnis durchdacht wirkt, sich schnell anfühlt und dennoch zum Produkt gehört.
Regel null: Verwende die eigenen Komponenten des Projekts
Jede Änderung erfolgt über das, was das Projekt bereits verwendet. 21 Grams UI erstellt niemals einen parallelen Satz von Komponenten.
- Erstelle ein Inventar, bevor du etwas anfasst. Notiere die Design-Tokens oder das Theme (CSS-Variablen, Tailwind-Konfiguration, Theme-Dateien), die Komponentenbibliothek (shadcn/ui, Radix, MUI, Chakra, ein hauseigenes Kit, ein Kundendesignsystem), das Icon-Set, die Diagrammbibliothek und die Animationsbibliothek. Erfasse, wie jede gemeinsam genutzte Komponente heißt und wo sie sich befindet.
- Korrigiere Dinge dort, wo sie leben. Eine Button-Regel geht in den
Buttondes Projekts (ein Token, eine Variante, ein Prop oder seine Styles), niemals in eine einmalige Kopie auf einem einzelnen Bildschirm. Eine Farb- oder Radiusregel geht in das Token, nicht in hartcodierte Werte. - Füge niemals eine Komponente hinzu, wenn es bereits eine für diese Aufgabe gibt, und füge niemals eine Abhängigkeit (UI-Kit, Icon-Set, Diagramm- oder Animationsbibliothek) hinzu, um einen 21 Grams UI-Effekt zu erzielen. Verwende, was installiert ist. Ohne Animationsbibliothek verwende CSS-Übergänge.
- Wenn ein Teil wirklich fehlt (kein Segmented Control, kein Switch), baue es aus den vorhandenen Primitiven und Tokens des Projekts auf, unter Einhaltung der Dateistruktur und Benennung des Projekts. Gib dies im Bericht an.
- Die Hausstil-Werte sind nur Standardwerte für Lücken.
rules/undtokens/tokens.cssgeben Werte für das, was das Projekt nicht festgelegt hat. Bilde sie auf die Projekt-Tokens ab. Fügetokens.cssniemals zusammen mit einem bestehenden System ein. - Die Marke bleibt die des Projekts. Markenfarben, Schriftarten, Logos, Icon-Stil und Stimme werden nie ersetzt. 21 Grams UI verändert, wie sie verwendet werden (Kontrast, Hierarchie, Abstände, Bewegung), nicht was sie sind.
Rangfolge: die Worte des Benutzers, dann das Designsystem und die Marke des Projekts, dann der 21 Grams UI Hausstil. Die Prinzipien, Hacks und Animations-Crafts gelten überall, ausgedrückt in den eigenen Komponenten des Projekts.
Was enthalten ist
- Hausstil. Acht Bereiche in
rules/:radius.md(12/8/4 verschachtelt),buttons.md(36px, .97 Drücken),motion.md(weich, vom Auslöser, kein Hüpfen),type.md(eng, wenige Größen),spacing.md(gruppiert 4pt),colour.md(ein Akzent, AA),elevation.md(tonale Füllungen),copy.md(klar und hilfreich). Plus drei Komponentendateien:icons.md(ein Stil, Linie, Vollfläche oder Duoton, niemals gemischt),charts.md(Linie, Säulen- und horizontale Balken) undtoggles.md(Switch und Segmented Control). Standardwerte sind intokens/tokens.css. - Die 20 Prinzipien. UX- und Animationsprinzipien in
references/principles.md. - Die 10 Design-Hacks. CSS-Details auf Handwerksebene in
references/design-hacks.md. - Die 20 Animations-Crafts. Bewegungsregeln auf Implementierungsebene (Ursprünge, Dauern, Staffelung, Drücken, Ziehen, gemeinsames Layout) in
references/animation-craft.md. - Die 10 Typografie-Hacks. Reservierte fette Breite,
text-box-trim, Unterstreichungsabstand, Hochstellung-Abstand, fließende Anzeigetypen, Kapitälchen-Akronyme, typografische Anführungszeichen, mittlere Abschneidung, automatische Silbentrennung und zeilenweise abgeschnittene Titel inreferences/typography.md. - Die 20 Unslop-Regeln. Kompositions- und Inhaltsmerkmale (Füll-Badges, redundante Labels, zufällige Kursivschrift, dekorative Monospace, abstrakte Heldenkunst, gleichgewichtige Features, vage Überschriften, Glühen, optische Ausrichtung, Ladezustände) in
references/unslop.md.
Wenn ein Datenvisualisierungs-Skill installiert ist, lade ihn ebenfalls, wenn ein Diagramm beteiligt ist.
Arbeitsablauf
- Erstelle das Inventar (Regel null). Wenn das Projekt überhaupt kein Designsystem hat, sage dies und verwende die Hausstil-Standardwerte.
- Auditiere, bevor du irgendwas änderst. Gehe durch den Bildschirm oder die Komponente und liste die Befunde gruppiert nach Bereich (Radius … Kopie), Prinzipnummer, Hacknummer und Craftnummer auf. Verwende die Checklisten am Ende von
references/principles.md,references/design-hacks.md,references/animation-craft.md,references/typography.md,references/unslop.mdundrules/icons.md. Jeder Befund erhält die Datei und Zeile, was falsch ist, die Korrektur und in welche vorhandene Komponente oder welches Token die Korrektur geht. Markiere jede Stelle, an der eine 21 Grams UI-Regel mit dem Designsystem des Projekts kollidiert, damit der Benutzer entscheiden kann, welche gewinnt. - Zeige das Audit dem Benutzer als kurze Liste und frage vor der Anwendung umfangreicher Änderungen nach. Kleine, offensichtliche Korrekturen im angeforderten Umfang können direkt vorgenommen werden.
- Wende die Korrekturen in dieser Reihenfolge an: Tokens → gemeinsame Komponenten → Bildschirme. Halte die Diffs auf das Auditiere beschränkt und in den eigenen Konventionen des Projekts (Formatierung, Lint, Benennung).
- Verifiziere im Browser. Vorher-Nachher-Screenshots jedes geänderten Bildschirms. Überprüfe Hover, Drücken, Fokus, Laden, Fehler, beide Themes und reduzierte Bewegung. Messe Button- und Textkontrast; schätze nicht nur. Für Bewegungen zeichne falls möglich das Vorher und Nachher auf. Eine Vorher/Nachher-Seite mit einem verschiebbaren Trenner und funktionierenden Interaktionen auf beiden Seiten ist der klarste Weg, um eine Verbesserung zu überprüfen.
- Berichte, was sich pro Bereich, Prinzip, Hack und Craft geändert hat, welche Komponenten und Tokens berührt wurden und was unerledigt geblieben ist.
Hausstil auf einen Blick (Standardwerte für Lücken)
- Radius 12 Container / 8 Steuerelemente / 4 kleine Teile, verschachtelt als Außenminus-Padding. Keine Pillen außer Tags und Toggles.
- Buttons 36px (32 kompakt, 40 prominent), Radius 8, 14/500, eine solide primäre, eine primäre pro Ansicht, Hover = nur Farbstufe, Drücken = Farbstufe +
scale(.97)150ms, Laden behält Breite. - Bewegung: kein Hüpfen bei alltäglicher UI. Menüs 220ms rein / 175ms raus ab
scale(.95)am Auslöser, Panels 240 / 190, Eintritteease-out, Austritteease-in(~80% des Eintritts), Listenzeilen gestaffelt 30ms, häufige Interaktionen sofort. - Typografie: die Schriftarten des Projekts (Geist, wenn es keine gibt). Mono ist nur für Code, niemals für Labels, „Augenbrauen“, Badges, Zeitstempel oder Zahlen (
tabular-numsin der Sans-Ausrichtung der Ziffern). Größen 12/14/16/22/28, Gewichte 400/500/600, Überschriften −0.022em, höchstens vier Größen pro Bildschirm. Auf Mobilgeräten gehen Überschriften eine Stufe hoch: Abschnitt 18, Karte 16. - Chat-Senden auf Mobilgeräten ist ein Nur-Icon 44×44 Paper-Plane-Button mit
aria-label="Senden". - Abstände: 4pt-Skala. Enger innerhalb von Gruppen als zwischen ihnen (4 / 6 / 16 / 24–32 / 48). Select-Pfeil 12px von rechts,
padding-right36px. - Farbe: ein Akzent (Aktionen, Fokus, Auswahl), Statusfarben getrennt, Button-Text ≥ 4.5:1 in beiden Themes mit
--on-accentpro Theme. - Erhebung: ruhende Oberflächen sind ein Füllschritt ohne Rahmen oder Schatten. Nur schwebende Ebenen erhalten einen Ring und Schatten. Dunkler Modus ist pro Ebene heller.
- Icons: ein Stil pro Produkt, Linie, Vollfläche oder Duoton, und niemals gemischt in einem Menü, Navigationsleiste, Symbolleiste, Liste oder Karte. Ausgewählte Zustände ändern die Farbe, nicht den Icon-Stil. Eine Icon-Bibliothek, eine Strichstärke, eine Größe pro Gruppe.
- Kopie: Verb+Objekt-Buttons, Fehler mit Ursache und Lösung, Satzfall, kein Emoji, keine Übertreibungswörter.
Unverhandelbare (aus den 20 Prinzipien)
- Benutzerausgelöste UI-Bewegung ist 120–300ms, und Austritte sind etwa 80% des Eintritts. Niemals
linearfür Bewegung. - Easing entspricht der Richtung: Eintritt
ease-out, Austrittease-in, A→B auf dem Bildschirmease-in-out. Kein Überschwingen bei alltäglicher UI. - Hochfrequente Interaktionen (Tastaturnavigation, Listenhervorhebung, Tabs in Werkzeugen) sind sofort.
- Jede Eingabe wird in unter 100ms bestätigt. Verwende optimistische UI für Speicherungen. Zeige Fortschritt nach 400ms.
- Trefferflächen sind mindestens 44×44 auf Touch und 32×32 auf dichtem Desktop, auch wenn das Symbol kleiner ist.
- Ein Fokus und eine primäre Aktion pro Ansicht. Dimm den Kontext, wenn etwas den Fokus bekommt.
- Lange Zahlen werden in Blöcke gruppiert. Eingaben akzeptieren unordentliche Formate und geben den bereinigten Wert zurück.
- Standardplatzierung und -symbole, sofern es keinen Grund gibt, davon abzuweichen.
- Jeder Komponentenzustand ist entworfen: Leerlauf, Hover, Drücken, Laden, Erfolg, Fehler, deaktiviert.
prefers-reduced-motion: Bewegung, Skalierung und Überschwingen entfernen, eine kurze Deckkraftänderung beibehalten.
Unverhandelbare (aus den 10 Hacks)
- Verschachtelter Radius: innen = außen − Padding.
- Rahmen sind Alpha (
rgb(0 0 0 / .12)), niemals durchgehendes Grau-Heax auf unterschiedlichen Oberflächen. - Paletten und Verläufe in OKLCH (
in oklchbei Verläufen). - Icon-Strichstärke entspricht der Gewichtung des benachbarten Textes.
- Horizontale Scrollenblenden an den Rändern mit einer Maske.
- Icon-Wechsel überblenden mit
filter: blur(4px). - Dunkler Modus: jede höhere Ebene ist heller (Seite < Karte < Menü).
- Mobile Vollhöhe:
dvh/svh, niemals nacktes100vh. - Produktfotos mit weißem Hintergrund auf getönten Karten:
mix-blend-mode: multiply.
Unverhandelbare (aus den 10 Typografie-Hacks)
- Fett bei Hover oder Auswahl verschiebt niemals das Layout (reserviere die fette Breite).
- Einzeilige Labels in Buttons und Badges sind optisch zentriert (
text-box-trim). - Link-Unterstreichungen klären Unterlängen (
text-underline-offset: 0.2em). Hochstellungen unterbrechen den Zeilenrhythmus nicht. - Echte Interpunktion in Kopie: typografische Anführungszeichen, Apostrophe, Gedankenstriche,
…. - Namen, die sich am Ende unterscheiden, werden mittig abgeschnitten. Kartentitel in Rastern werden auf die gleiche Zeilenanzahl begrenzt.
Unverhandelbare (aus den 20 Animations-Crafts)
- Popover und Menüs wachsen aus ihrem Auslöser heraus (
transform-originam Auslöser), beginnen beiscale(.95), niemalsscale(0), und gehen zurück in den Auslöser. - Alter und neuer Zustand überlappen sich. Es gibt niemals einen leeren Frame zwischen Speichern und Gespeichert.
- Ziehbewegungen folgen dem Zeiger 1:1 ohne Übergang während des Haltens und gummibandartig über die Grenzen hinaus.
- Karten → Detail expandiert dasselbe Element (gemeinsame
layoutId/ View-Transition), niemals einen getrennten Ersatz. - Segmented Controls und Tabs enthüllen das aktive Label mit einer Maske, die mit dem Indikator wandert.
- Bewegliche Knöpfe dehnen sich um etwa 12% (flächenerhaltend). Erfolg erhält einen Puls.
Zu entfernende KI-Merkmale
Gemischt Icon-Stile (ein gefülltes Haus neben einem Umriss-Ordner, ein Umriss-Icon, das bei Auswahl gefüllt wird), zwei Icon-Bibliotheken auf einem Bildschirm, Emoji als Icons verwendet, „NEU“-Füllpillen über Überschriften, Augenbrauen, die die Überschrift wiederholen, ein zufälliges kursives oder Mono-Wort in einer Überschrift, Mono-Labels, -Augenbrauen, -Badges, -Zeitstempel oder -Zahlen („tech“ in Großbuchstaben Mono wie // 01 STATUS), glänzende 3D-Orbs anstelle des echten Produkts, Reihen gleicher Feature-Karten, „X, lerne Y kennen.“-Überschriften, leuchtende Gradientenrahmen, Indigo-zu-Violett-Verläufe, Gradiententext, farbige Glühschatten, derselbe 16px Radius auf allem (innerer Radius gleich äußerer), Pill-Buttons neben abgerundeten Eingaben, Hover-Vergrößerung auf Karten und Buttons, 300ms ease-in-out auf allem, Einblenden nach oben beim Laden der Seite, einheitliches p-6 gap-6, Karten in Karten, Schatten plus Rahmen plus Radius auf jedem Block, grey-500 für allen sekundären Text, Emoji in Überschriften und Texte wie „Entsperren“, „Superaufladung“, „Nahtlos“ oder „Ups!“.
Credits
Die Prinzipien, Hacks und Animations-Crafts sind aus fünf kurzen Design-Videos paraphrasiert und erweitert worden: „20 Principles of UX & Animation“, „10 Niche Design Hacks“, „20 Ways to Make Beautiful AI Animations“, „10 Niche Typography Hacks“ und „20 Ways to Unslop AI Designs“. Siehe die README für die Quellenangaben.