remotion-colour-family
Erzeugt eine vollständige Palette aus minimalen Ankern. Verwendet den contrast()-Helper aus remotion-studio/src/colour/index.ts.
Auslöser (Triggers)
- BrandConfig fehlen die Blöcke
secondary,accent,neutralodersemantic. - Ein Render-Versuch scheitert am Kontrast: Ein beliebiges Text-auf-Hintergrund-Paar hat ein Verhältnis < 4,5.
- Der Benutzer sagt „Erweitere die Palette für {brand}" oder „Prüfe die Farbe (audit colour)".
Eingaben (Inputs)
- 1-3 Hex-Anker (Primär ist erforderlich; Sekundär und Akzent sind optional).
family:restoration|safety|industrial|consumer|trainingschool(optional):editorial-monocle|modern-minimal|warm-soft|tech-utility|brutalist-experimental— visuelles Schul-Preset (Open-Design-Abstammung). Wählt den Schriftzeichen-Typus, die Kontrast-Neigung und die Akzentrolle bevor die Familienheuristiken greifen. Standard:modern-minimal.- Vorhandene Palette (bei Erweiterung)
Methode
-
Schul-Preset — wende die
school-Voreinstellung zuerst an. Jede Schule legt den Farbtonbereich, den Helligkeitsbereich, die Temperatur der Neutraltöne und die Akzentsättigung fest:Schule Farbton-Neigung Helligkeits-Neigung Neutraltöne Akzentsättigung Referenz (eingebunden) editorial-monoclewarme Erdtöne (Terrakotta/Ton/Sand) hoch (Pergament/Elfenbein) nur warme Grautöne – jedes Grau trägt einen gelb-bräunlichen Unterton ein chromatischer Akzent, tief erdig _library/claude/,_library/monocle/(falls vorhanden)modern-minimalkühl neutral (Schiefer/Blau-Grau) ausgewogen echte Grautöne ein elektrisierender Akzent, <3× pro Viewport verwendet _library/airbnb/,_library/cal/warm-softwarme Pastelltöne (Pfirsich/Erdbeercreme/Sahne) hoch warme Grautöne + cremige Tönungen gering gesättigtes Rosa/Koralle _library/airtable/,_library/cafe/tech-utilityIndigo / Cyan / Schiefer niedrig (dunkle Oberflächen bevorzugt) kühle Grautöne in Richtung Schiefer-900 Cyan-Signal-Akzent, nur für Deltas/Status verwendet _library/binance/,_library/arc/brutalist-experimentalhoher Kontrast von Primär auf rohem Weiß extrem hoch + extrem dunkel nur reines Schwarz/Weiß scharfes Neon, aggressiv eingesetzt _library/brutalism/,_library/bold/ -
Familien-Heuristiken — werden nach der Schule angewendet. Die Familie liefert die kanonischen Nachbarfarben:
safety: Marineblau + Signalorange + Elfenbeinrestoration: Teal + Schiefer + Limetteindustrial: Graphit + Stahl + Bernsteinconsumer: Hero-Rot/Blau + warmes Weiß + Schiefertraining: Terrakotta + Sahne + Tinte
-
Erzeuge in OKLch — arbeite im OKLch-Farbraum, nicht in HSL, damit Farbton-Drehungen die wahrgenommene Helligkeit erhalten. Konvertiere Hex-Anker zuerst in OKLch; drehe den Farbton um ±30°/±60°, während die Helligkeit innerhalb des durch die Schule vorgegebenen Bereichs gehalten wird. Wandle das Ergebnis für die
BrandConfig-Speicherung zurück in Hex um. Behalte einoklch-Geschwisterfeld im Kontrastbericht für nachgelagerte Tailwind-4-Verbraucher (Phase 2). -
Determinismus — das gleiche
(primary, family, school)-Tripel MUSS bei jeder Ausführung die gleiche Ausgabepalette erzeugen. Keine Zufälligkeit; kein Rauschen; keine LLM-Interpolation. Der Generator ist eine reine Funktion seiner Eingaben. -
Erzeuge Neutraltöne — interpoliere zwischen
oklch(99% 0 hue)(50) undoklch(15% 0 hue)(900), wobei die Chroma gemäß der Schul-Voreinstellung in Richtung des Primärfarbtons geneigt wird (warm-soft zieht Neutraltöne warm; tech-utility zieht sie kühl). -
Erzeuge semantische Farben — wähle
success/warning/dangeraus einem festen Pool, der nicht mit der Primärfarbe kollidiert. -
Erzeuge Dunkelvariante — invertiere die Neutraltöne (Helligkeit
50 ↔ 900) und verschiebe die Primärfarbe im OKLch-Raum um 8 % Helligkeit nach oben. -
Validiere — für jedes Paar
(primary, neutral.50),(primary, neutral.900),(secondary, neutral.50),(accent, secondary)stelle sicher, dass der Kontrast ≥ 4,5 (WCAG-AA) beträgt. Falls nicht, generiere den fehlschlagenden Slot neu. Brutalist-experimental erfordert ≥ 7,0 (AAA).
Ausgabe (Output)
Zwei Artefakte:
- JSON-Kontrastbericht mit OKLch-Koordinaten (für
remotion-brand-codifyund Phase 2 Web-Konsum):
{
"school": "modern-minimal",
"family": "restoration",
"tokens": {
"primary": { "hex": "#0E7C7B", "oklch": "oklch(48% 0.10 195)" },
"neutral": {
"50": { "hex": "#F5F7F8", "oklch": "oklch(97% 0.005 200)" },
"900": { "hex": "#0E1518", "oklch": "oklch(15% 0.010 215)" }
}
},
"passes": [ { "fg":"#F5F7F8", "bg":"#0E7C7B", "ratio": 7.21, "level":"AAA" } ],
"fails": []
}
- YAML-Fragment, bereit zum Einfügen in den
colors:-Block vonSynthex/packages/brand-config/src/brands/{slug}.design.md— die Token-Namen folgen der@google/design.md-Spezifikation (Kleinbuchstaben + Bindestriche für Ebenen-Namen, z. B.neutral-50,dark-primary):
colors:
primary: "#0E7C7B"
secondary: "#2A3D45"
accent: "#C5E063"
neutral-50: "#F5F7F8"
neutral-100: "#E4E9EC"
neutral-500: "#6F7B82"
neutral-900: "#0E1518"
success: "#3FA34D"
warning: "#E0A800"
danger: "#C0392B"
on-primary: "#FFFFFF"
on-secondary: "#FFFFFF"
on-accent: "#0E1518"
surface: "{colors.neutral-50}"
on-surface: "{colors.neutral-900}"
dark-primary: "#16B5B3"
dark-secondary: "#1A2428"
dark-surface: "#0E1518"
dark-on-surface: "#F5F7F8"
Führe npx --prefix Pi-Dev-Ops/remotion-studio design.md lint auf der resultierenden .design.md aus, um null Kontrastfehler zu bestätigen.
Grenzen (Boundaries)
- Liefere niemals eine Palette mit einem AA-Fehler aus — blockiere und fordere eine Entscheidung des Gründers für den fehlschlagenden Slot an.
- Überschreibe niemals ein explizites
darkVariant, das von der Marke gesetzt wurde. - Verwende niemals Rot als Primärfarbe, es sei denn,
family === 'consumer'und der Markenname verankert explizit Rot. - Greife niemals während der Generierung auf ein LLM zurück — die Funktion ist deterministisch. Wenn der Determinismus fehlschlägt (gleiche Eingabe → unterschiedliche Ausgabe bei verschiedenen Durchläufen), ist das ein Fehler im Generator, kein Feature.
- Mische niemals zwei Schulen — wähle eine aus. Die Mischung von
editorial-monocle-Wärme mittech-utility-Schiefer erzeugt die matschige „KI-Standardpalette“, mit der jede Marke beginnt.
Übergabe an
remotion-brand-codify schreibt das Ergebnis in src/brands/{slug}.ts.