Communitygithub.com

ui-ux-mastery

Studio-Qualität UI/UX für immersive und 3D-Websites — Typografie-Systeme, Farb-Tokens und Kontrast, Layout über bewegten 3D-Elementen, Textpanels, Navigation und Telefonmenüs, benutzerdefinierte Ladebildschirme, Scroll-Hinweise, Mikrointeraktionen und Beschleunigung, Textgestaltung, Barrierefreiheit und reduzierte Bewegung.

Was ist ui-ux-mastery?

Der Skill `ui-ux-mastery` ist ein umfassender Leitfaden zur Gestaltung immersiver Websites mit 3D-Elementen, die aussehen wie von einem Spitzenstudio. Er definiert ein vollständiges Designsystem mit Typografie (Display-Serif für Titel, geometrische Sans für UI), Farb-Tokens auf `:root` (mit warmen, gedämpften Tönen und einem einzelnen Akzent), Layout über 3D-Szenen (Desktop: seitliche Panels, Mobil: unteres Blatt) und einer konsistenten Bewegungssprache (expo-out-Beschleunigung). Der Skill behandelt außerdem einen ehrlichen Ladebildschirm mit Inline-CSS, einen Scroll-Hinweis, Navigation und Barrierefreiheit. Er wird als Referenz beim Entwerfen oder Überprüfen von Interfaces, Portfolios, Landingpages oder Heldenbereichen eingesetzt, um „generische“, „KI-erstellte“ oder „überladene“ Optiken zu vermeiden und Lesbarkeit auf bewegten Hintergründen sicherzustellen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/forpc1428-eng/cosmic-forge/tree/HEAD/skills/ui-ux-mastery

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

UI/UX-Meisterschaft für immersive Websites

Referenz: templates/event-horizon/css/style.css, index.html (inline Loader), js/main.js.

1. Typografie (2 Schriftfamilien, strenge Rollen)

  • Display-Serif (Bodoni Moda / Didot / Playfair-Klasse) für Titel: Stärke 400, Tracking −0.02em, Zeilenhöhe 0.9–1.0, Größen clamp(44px, 9vw, 148px). Kursiv + abgedunkelte zweite Zeile für Betonung.
  • Geometrische Sans (Montserrat / Inter) für UI: 10–11 px, Stärke 500, GROSSBUCHSTABEN, Tracking 0.24–0.38em. Fließtext 14–15 px, Zeilenhöhe 1.65–1.75, max. 46 Zeichen.
  • Selbst gehostetes WOFF2, font-display: swap, die 2 Dateien vorladen, die der erste Bildschirm verwendet.
  • Hierarchie je Panel: Vorspann (Akzent, Großbuchstaben) → Titel (Serif) → Fließtext (gedimmt) → Liste/Aktionen.

2. Farbe

Tokens auf :root, niemals rohe Hex-Farben in Komponenten: --bg #000 · --fg #f4efe8 (warmes Weiß, nicht rein) · --dim rgba(fg,.55–.62) · --faint rgba(fg,.14–.18) (Linien, Rahmen) · --accent #ffb070 (ein warmer Akzent, sparsam verwendet).

  • Akzent nur bei: Vorspann-Labels, aktiver Nav-Unterstrich, Fortschritt, Hover, dem Licht des Scroll-Hinweises.
  • Text über 3D: weicher radialer Schirm hinter den Panels (radial-gradient(closest-side, rgba(0,0,0,.5), transparent)) und ein oberer/unterer Verlauf auf der Bühne. Kontrast ≥ 4.5:1 für Fließtext in jedem Frame.
  • Niemals: Neon, Glassmorphismus überall, mehrere Akzentfarben, verlaufender Text.

3. Layout über 3D

  • Fixierte Leinwand; Inhalt schwebt in einem fixierten Overlay. Panels: Desktop linke/rechte Spalte min(88vw,520px), vertikal zentriert, gegenüber dem Motiv. Telefone: unteres Blatt (max 60vh, Verlaufshintergrund, Safe-Area-Padding), Motiv darüber gerahmt.
  • 8-Punkt-Abstands-Skala, --pad: clamp(16px, 5vw, 80px), großzügiger Negativraum.
  • Panel-Sichtbarkeit gesteuert durch Reisefortschrittsfenster mit abgemilderten Einblendungen (2 % ein, 1.5 % aus), translateY 24–36 px, pointer-events nur sichtbar.
  • HUD/Labels unten links in Mikro-Großbuchstaben (Name · echter Fakt, z.B. „Saturn · 9.58 AE“). Echte Fakten verleihen Glaubwürdigkeit; erfundene zerstören sie.

4. Loader (muss im ersten Frame zeichnen)

  • Inline-kritisches CSS + Markup in index.html. Markenname in der Display-Serif mit einer gestaffelten Wortenthüllung, einem dünnen Fortschrittsring/-balken und einem numerischen Prozentwert.
  • Ehrlicher Fortschritt: ~0–60 % während der Shader-Kompilierung (abgemilderter Fake-Fortschritt in Richtung 55 %), 60–100 % für die kritischen Texturen des Helden. Enthüllen wenn bereit oder nach max. 3.5 s — niemals hängen bleiben.
  • Ausblenden 1–1.2 s mit expo-out; der Heldentext steigt dann ein (Staffelung 120 ms).

5. Scroll-Hinweis (ruhezustandsbewusst)

  • Kleine, matte Pille auf der rechten Seite: vertikales „SCROLL“ + ein Licht, das an einer Haarlinie entlangläuft + ein wippendes Chevron.
  • Erscheint nach ~1.2 s der Ruhe mit einer weichen Unschärfe-Einblendung (0.9 s); verschwindet in 0.25 s bei jedem Scrollen.
  • Auf der Landingpage versteckt (diese hat einen eigenen Hinweis), während des Loaders und bei geöffnetem Menü.
  • Am Ende wird es zu „ZURÜCK NACH OBEN“ (Animationen umgekehrt) und ist anklickbar.
  • Stolperfalle: Niemals eine Zustandsklasse top, active, hidden nennen … die mit anderen Komponenten kollidiert.

6. Navigation

  • Desktop: Marke links, 4 kurze Links in Großbuchstaben rechts, Akzent-Unterstrich beim aktiven Abschnitt.
  • Telefone: 2-zeiliger Burger → Vollbild verschwommenes Blatt mit großen Serif-Links. Schließen bei Auswahl.
  • Links scrollen (sanft) zur Mitte des Inhalts-Haltefensters, durch die 3D-Reise.

7. Bewegungssprache

  • Eine Beschleunigungsfamilie: expo-out cubic-bezier(.16,1,.3,1) für Eingänge, (.87,0,.13,1) für Schleifen.
  • Dauern: Mikro 0.25–0.4 s, Enthüllungen 0.9–1.6 s. Ausgänge schneller als Eingänge.
  • prefers-reduced-motion: Schleifen stoppen, steifere Scroll-Feder, keine Drift, keine Körnungs-Animation.

8. Textgestaltung

Kurz, selbstbewusst, spezifisch. Titel = 2–4 Wörter + kursives Echo („Wo Ideen / geboren werden.“). Fließtext ≤ 2 Sätze. Projektlisten: Name + „Typ · Jahr“. Kein Lorem ipsum in ausgelieferten Arbeiten.

9. Barrierefreiheit & Pfiff

Semantische Sehenswürdigkeiten (Landmarks), aria-hidden auf dekorativen Schichten, echte <button>s, sichtbarer Fokus, lang, title/description/OG-Tags, ein SVG-Favicon, theme-color #000, color-scheme: dark, kein horizontales Scrollen bei 320 px, Antippziele ≥ 40 px.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Verwandte Skills