Design & UI
Gestalte Oberflächen, die absichtsvoll und hochwertig wirken, nicht nach Vorlage generisch. Dies ist der mit Abstand größte Hebel für Qualität im App-Builder. Wende es auf DOM / Overlay UI an – Seiten, Chrome, HUD, Menüs, Formulare. (Für die Spielgrafik eines 3D-Spiels siehe das building-games Skill; dieses Skill gilt für die darüber liegende DOM-UI.)
Lies references/ für tiefergehende Details (wird bei Bedarf geladen – nicht alles einfügen):
references/refined-ui.md– das vollständige Designsystem für Produkt-Chrome/Overlay.references/typography.md– Schriftskala, Paarung, Rhythmus.references/surfaces.md– Höhe, Rahmen, Schatten, Schichtung.references/animations.md– Bewegung, Easing, Übergänge.references/performance.md– UI flüssig halten (60fps, kein Ruckeln).
1. Design-System-zuerst (dies tun, bevor du etwas stylst)
Definiere das System einmal und setze dann daraus zusammen. Streue niemals ad-hoc Werte.
- Tokens in CSS (Tailwind v4 ist CSS-first). Lege die Palette, Radien und Schriftarten in
src/styles.cssunter@themeals CSS-Variablen fest; verwende sie als Tailwind Utilities. Eine einzige Quelle der Wahrheit.@import "tailwindcss"; @theme { --color-bg: #0b0b0f; --color-surface: #16161d; --color-fg: #e7e7ea; --color-muted: #a0a0ab; --color-primary: #14b8a6; --color-border: #26262f; --radius: 0.75rem; --font-sans: "Inter", system-ui, sans-serif; } - Verwende shadcn/ui Komponenten (Radix-Primitive +
cva-Varianten +tailwind-merge) für Buttons, Dialoge, Dropdowns, Eingabefelder usw. Sie sind barrierefrei und konsistent. Generiere sie insrc/components/ui; style über Tokens, nicht über inline Hex-Codes. - Tailwind v4 Basis-Fix – Buttons brauchen einen Zeiger-Cursor. v4's Preflight setzt für
<button>den Cursor aufcursor: default, was sich kaputt anfühlt. Füge dies einmal insrc/styles.csshinzu, damit Buttons/klickbare Rollen einen Zeiger zeigen:@layer base { button:not(:disabled), [role="button"]:not(:disabled) { cursor: pointer; } } - Verbiete ad-hoc Styling: kein roher Hex-Code in JSX, keine
text-white/bg-blackLiterale, keine beliebigen Werte wiep-[16px]odertext-[13px]. Wenn du einen Wert brauchst, wird er zu einem Token oder einem Skalenschritt.
2. Der quantifizierte Katalog (einfache Regeln, die „hässlich“ verhindern)
- ≤ 3–5 Farben insgesamt (eine Primärfarbe + Neutrale + höchstens eine Akzentfarbe). Keine zufälligen zusätzlichen Farbtöne. Verwende standardmäßig kein Lila, es sei denn, es wird verlangt.
- ≤ 2 Schriftfamilien (oft eine). Kombiniere eine Überschriften-/Anzeigeschrift mit einer Textschrift oder verwende nur eine.
- Zeilenhöhe 1.4–1.6 für Fließtext; enger für große Überschriften.
- Wenn du eine Hintergrundfarbe überschreibst, überschreibe auch die Vordergrund-/Textfarbe (der Kontrast muss stimmen – überprüfe sowohl helle als auch dunkle Modi).
- Mobile First: Gestalte zuerst das ~390px Layout, dann skaliere nach oben. Kein horizontaler Überlauf; Tippziele ≥ 44px.
- Konsistente Abstandsskala (4/8-basiert). Großzügiger Weißraum ist besser als zu eng.
- Ein Akzent, sparsam eingesetzt für primäre Aktionen – nicht überall.
3. Anti-KI-Schrott (die Merkmale, die Output generisch aussehen lassen – vermeiden)
- Keine Gradienten-Blob-Füller, keine riesigen Hero-Gradienten als Ersatz für Inhalt.
- Keine Emojis als Icons – verwende ein echtes Icon-Set (
lucide-react). - Keine handgezeichneten SVG-Illustrationen/Karten/Diagramme – verwende echte Bibliotheken (
rechartsfür Diagramme) oder echte generierte Bilder. - Keine Platzhalterbilder / Lorem-Grau-Boxen im Endprodukt – generiere echte Bilder oder verwende echte Inhalte; setze
crossOrigin="anonymous"bei Canvas-Bildern. - Vermeide den Look überstrapazierter Schriftarten (nur System-Schriftarten oder Comic Sans-ähnliche Auswahlen).
- Jedes Element verdient seinen Platz. Reduziere dekoratives Rauschen. Etabliere ein System und variiere dann mit Absicht – nicht willkürlich.
- Passe dich der bestehenden UI an, wenn du eine App bearbeitest; führe keine zweite visuelle Sprache ein.
4. Layout & Hierarchie
- Klare visuelle Hierarchie: eine primäre Aktion pro Ansicht; Größe/Gewicht/Farbe drücken Wichtigkeit aus. Siehe
references/typography.mdundreferences/surfaces.md. - Verwende echte Layout-Strukturen (Grid/Flex, Container max-widths), keine absolute-Positionierungs-Hacks. Richte an einem konsistenten Grid aus.
- Leere Zustände, Ladezustände und Fehlerzustände sind Teil des Designs – liefere keine leeren/ruckeligen Zwischenzustände aus.
5. Bewegung (dezent, zielgerichtet)
- Kurze, abgerundete Übergänge (150–250ms) bei Hover/Press/Enter; respektiere
prefers-reduced-motion. Details inreferences/animations.md. - Anime Layout niemals so, dass es zu Ruckeln führt; bevorzuge transform/opacity.
6. Spiel-Overlays (wenn dies mit building-games kombiniert wird)
Die Spielgrafik wird von building-games verwaltet. Dieses Skill stylt das DOM Overlay: Start-/„Klicke zum Spielen“-Bildschirm, HUD, Punktestand, Menüs, Pause, mobile Steuerung. Halte das Overlay lesbar über dem Canvas (Hintergrund, Kontrast) und halte es aus dem Pointer-Lock-/Spieleingabe-Pfad heraus.
Abschluss-Checkliste (bevor du die UI als fertig erklärst)
- Tokens in
@themedefiniert; keine ad-hoc Hex / beliebige Werte in JSX. - ≤ 5 Farben, ≤ 2 Schriftarten, konsistente Abstandsskala.
- Kontrast stimmt; Vordergrund überschrieben, wo Hintergrund überschrieben wird.
- Mobil (~390px) hat keinen Überlauf; Ziele ≥ 44px.
- Echte Icons/Bilder/Diagramme – keine der Anti-Schrott-Merkmale.
- Lade-/Leer-/Fehlerzustände behandelt; Bewegung dezent und reduziert-Bewegung-sicher.
- Gerendert und im Browser begutachtet (siehe AGENTS.md Verifikation), nicht nur per curl.