Communitygithub.com

kubai-liquid-glass

Füge Karten und Bedienfeldern in deinem Produkt ein flüssiges Glasmaterial hinzu: Hintergrundunschärfe und -aufhellung, Randbrechung und Farbdispersion, automatisch angepasste Färbung und Textfarbe, klare Lesbarkeit in hellen und dunklen Modi, beibehaltenes Layout (Liquid Glass, Glassmorphismus).

Was ist kubai-liquid-glass?

Diese Fähigkeit implementiert einen 'Liquid Glass'-Materialeffekt, der Karten und Bedienfeldern in jedem UI-Produkt einen hochwertigen Glas-Look verleiht, der sich dynamisch an den dahinterliegenden Hintergrund anpasst. Sie funktioniert auf Bildern, Tapeten und Videos in einer bestehenden Design-Umgebung, ohne Markup, Layout, Schriftarten oder Abstände zu verändern. Sie definiert das Material als eine Reihe von Token pro Zustand (hell/dunkel), die Hintergrundunschärfe (`backdrop-filter`), Aufhellung, Sättigungsanpassung und einen Randlinseneffekt mit Farbdispersion (Rot/Blau-Verschiebung) für eine dicke, gebogene Kante kombinieren. Die Textfarbe mischt sich mit dem Glas, um auf unterschiedlichen Hintergründen lesbar zu bleiben. Die Fähigkeit umfasst eine adaptive Engine, die den Hintergrund stichprobenartig untersucht (5×3-Raster), um die Tönungsdichte, Sättigung und Textfarbe anzupassen, sodass das Glas natürlich aussieht. Ein Einstellungs-UI ermöglicht es Benutzern, die Gesamttönungsintensität für helle und dunkle Modi zu steuern. Sie achtet auf Barrierefreiheit (`prefers-reduced-transparency`, hohen Kontrast) und bietet Fallbacks für Browser, die keine `url()`-Anhänge in `backdrop-filter` (wie Firefox) unterstützen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/kubai087/vibedesign-skills/tree/HEAD/skills/kubai-liquid-glass

In Ihrer bevorzugten KI fragen

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

Dokumentation

Flüssiges Glasmaterial

999 kleine Tricks, um deinem Vibe-Produkt mehr Qualität zu verleihen – Ausgabe 010 · @kubai087

Wende die folgenden Änderungen im Projekt des Benutzers an. Die Anforderungen sind aus der Sicht des Benutzers formuliert: I, me, my beziehen sich auf den Benutzer. Halte an, um den Benutzer zu fragen, bevor du fortfährst, wenn etwas zuerst gefragt werden muss.

Änderungsanforderungen

Gib den Karten und Bedienfeldern in meinem Produkt ein flüssiges Glasmaterial: klares Glas, das seine Farbe von der Szene dahinter bekommt, am Rand wie eine dicke Platte aussieht, sich an das anpasst, was dahinter ist, und seinen Text sowohl im hellen als auch im dunklen Modus lesbar hält. Arbeite innerhalb meines bestehenden Designsystems. Dies ist eine Änderung der Oberfläche, nicht des Layouts: behalte mein Markup, Abstände, Radien, Schriftarten, Symbole und Texte bei.

  1. Beginne mit dem, was existiert
  • Finde jede Oberfläche, die über einem Bild, einer Tapete, einem Video oder einem unruhigen Hintergrund liegt: Karten, Player, Suchleisten, Werkzeugleisten, Menüs, Popover, Toasts. Liste sie mit ihrer Komponente und ihrem Standort auf.
  • Finde heraus, wie das Produkt zwischen hellem und dunklem Modus wechselt und wo seine Farb-Token leben. Das Glas wird in diese Token eingebaut, nicht in jede Komponente.
  • Lasse Oberflächen über einem einfarbigen Hintergrund in Ruhe; Glas über einer einfarbigen Fläche sieht nur grau aus.
  1. Das Material als Token Baue es als einen Satz von Variablen pro Zustand auf, sodass eine Oberfläche sich durch deren Verwendung dafür entscheidet. Die Zahlen sind ein Ausgangspunkt für eine UI in normaler Größe.
  • Helles Glas, dunkler Text (Standard): Tönung weiß bei 6–22 % (je nach Dichte, Schritt 4); Hintergrundfilter blur(2px) saturate(180 %) brightness(1.06), damit die Farbe von hinten kommt und lebendig statt milchig bleibt. Kante: inset 1.5px 1.5px 1px -1px white 95 %, inset -1.5px -1.5px 1px -1px white 55 %, inset 0 0 0 0.5px white 30 %, 0 0 0 0.5px black 6 %, 0 6px 24px black 8 %. Inneres Licht, auf einer Schicht innerhalb der Oberfläche: ein radialer Highlight von oben links (white 30 %, die bis 55 % ausläuft) und weiche innere Leuchten knapp innerhalb des Randes, heller oben und links, etwas Schatten unten.
  • Heller Modus über einem dunklen Bereich, heller Text: Tönung rgb(16 18 22) bei 10–30 %; Filter blur(2px) saturate(170 %), dann brightness(0.85); Kante: eine schwache weiße Innenlinie oben und eine 0.5px dunkle Kontur.
  • Dunkler Modus: Tönung rgb(20 20 24) bei 16–38 %; Filter blur(2px) saturate(160 %) brightness(0.8), was abdunkelt wie ein Multiplizieren mit Schwarz, anstatt matschig zu werden; die gleiche Kante und das innere Licht bei etwa einem Drittel ihrer Stärke, mit einer dunkleren Kontur und Schatten.
  • Tinte, eine Farbe in festen Schritten, die für alles auf dem Glas Gezeichnete verwendet wird: auf hellem Glas black 86 % (Titel, Symbole, Zeiten, Fortschritt), rgb(60 60 67) bei 70 % (sekundär); mix-blend-mode multiply; auf dunklem Glas white 94 %, rgb(235 235 245) bei 64 %; mix-blend-mode plus-lighter. Zeichne Symbole in der deckenden Farbe und blende das gesamte Symbol mit Opazität aus: eine durchscheinende Farbe verdunkelt sich, wo sich Striche und Füllungen einer Form überschneiden.
  • Eine hervorgehobene Zeile auf hellem Glas ist eine hellere Schicht des Glases: white 42 % bei Hover, 76 % bei Auswahl, mit einem weißen Strich. Niemals eine graue Waschung.
  • Registriere die numerischen und Farb-Token mit @property, damit eine Oberfläche zwischen Zuständen gleitet, anstatt zu springen.
  1. Wende es in vier Deklarationen an Jede Oberfläche ändert nur diese, und ihr Markup bleibt wie es ist:
  • background: die Tönung.
  • backdrop-filter: der Filter des Materials, dann die Randlinse (Schritt 3) zuletzt, damit die Farbschritte in einem Durchgang zusammengefasst werden und die Biegung scharf bleibt.
  • box-shadow: die Kante.
  • color: die Tinte, mit dem Mischmodus auf allem, was hineingezeichnet wird. Hover hellt die Tönung um etwa 14 % auf, anstatt einen Schatten anzuheben.
  1. Die Randlinse
  • Erstelle eine Verschiebungskarte für jede Oberfläche: Rot ist die seitliche Biegung, Grün die vertikale; 128 bedeutet keine Verschiebung. Nur ein Rand biegt sich; die Mitte bleibt flach.
  • Der Rand ist etwa 44px breit auf einer Karte (min(44px, die kurze Seite / 3.5), niemals unter 4px). Für eine dicke Platte schaut ein Punkt d vom Rand um 1.1 × Rand × (1 - d / Rand)^2.6 nach innen: hart am Rand, wo die Szene auf sich selbst zurückfaltet, und klingt bis zur inneren Kante des Randes aus.
  • Zeichne die Karte für dieselbe Ecke, die das CSS zeichnet. Wenn die Oberfläche corner-shape: superellipse() verwendet, folge dieser Kurve, nicht einem Kreis, sonst verpassen sich die Biegung und das Randlicht an den Ecken.
  • Setze es in einen SVG-Filter mit feImage (der Karte) und feDisplacementMap (scale = 2 × der größte Versatz), und füge url(#id) am Ende von backdrop-filter hinzu.
  • Teile es in Farben auf: drei Durchgänge, rot 15 % weiter und blau 15 % weniger, jeder auf seinen Kanal mit feColorMatrix beschränkt und mit Screen-Blends wieder hinzugefügt. Überprüfe die Ecken von breiten Rändern über unruhigen Hintergründen; verringere die Aufteilung, wo sie in Dunst übergeht.
  • Nur Chromium zeichnet url() in backdrop-filter. Überprüfe CSS.supports('backdrop-filter', 'url(#a)') und überspringe Firefox, das es parst und nichts zeichnet. Überall sonst bleibt das reine CSS-Glas erhalten.
  • Warte darauf, dass das Kartenbild dekodiert ist, bevor du eine Oberfläche auf den Filter richtest, sonst zeichnet sie ohne ihre Unschärfe. Gib jedem Filter eine eindeutige ID und ein eigenes . Baue Karten einmal pro Radius und Randbreite und verwende sie wieder; bei Größenänderung verschiebe die Karte, baue sie nicht neu.
  • Überspringe die Linse auf Oberflächen unter 32px und auf Oberflächen mit will-change oder eigener Compositing-Ebene (Menüs, animierte Bedienfelder), wo Chrome die Karte anstelle des gebogenen Hintergrunds zeichnen kann.
  1. Anpassung an das, was dahinter ist
  • Nimm für jede Oberfläche eine Stichprobe des Hintergrunds unter ihr in einem 5 × 3-Raster, verwerfe die beiden dunkelsten und die beiden hellsten Punkte und bilde den Durchschnitt. Die Leuchtkraft ist (0.299 R + 0.587 G + 0.114 B) / 255; die Textur ist der hellste Punkt minus der dunkelste.
  • Tinte: Im hellen Modus heller Text, wenn die Leuchtkraft unter 0.5 liegt. Halte die aktuelle Tinte innerhalb von ±0.05 der Linie, damit eine Oberfläche nicht daran flackert. Der dunkle Modus verwendet immer hellen Text. Benachbarte Oberflächen in einer Zeile teilen sich eine Entscheidung.
  • Dichte (0 dünn, 1 dicht) = 0.55 × wie nah der Hintergrund an der eigenen Helligkeit der Tinte ist + 0.7 × Textur + 0.3 × Chroma. Sie bewegt die Tönung zwischen ihrem dünnen und dichten Alpha.
  • Behaltene Sättigung = 1 - 0.75 × Chroma, mindestens 0.45, damit ein lebendiger Hintergrund das Glas nicht verfärbt.
  • Nimm erneut eine Stichprobe, wenn sich der Hintergrund, das Theme oder die Position einer Oberfläche ändert, und merke dir die letzte Tinte, damit der nächste Ladevorgang damit öffnet.
  • Wenn der Hintergrund kein lesbares Bild ist (Live-Video, Cross-Origin-Inhalt), wähle die Tinte aus dem Theme und verwende die dichte Tönung.
  1. Lasse die Leute die Tönung einstellen
  • Füge eine Einstellung für den hellen und eine für den dunklen Modus hinzu, die die Tönung von 0 bis 1,5 skaliert (1 ist das Material wie entworfen). Unter 1 wird die Helligkeitsanhebung im Filter dünner, sodass bei 0 nur die Unschärfe, der Rand und der Schatten übrig bleiben.
  • Jedes Theme behält seinen eigenen Wert; das Wechseln der Themes gleitet zu diesem Wert des Themes.
  1. Barrierefreiheit sicherstellen
  • Überprüfe den Textkontrast auf dem unruhigsten und dem dunkelsten Hintergrund, den das Produkt zulässt, bei der Standard-Tönung; erhöhe die Dichte, nicht die Opazität der Tinte, bis es bestanden wird.
  • Respektiere prefers-reduced-transparency und forced colors: Verwende als Fallback eine solide Oberfläche in derselben Tönung bei voller Opazität.
  • Behalte Fokusringe, deaktivierte Zustände und Fehlerfarben bei; Fehler behalten ihr Rot.
  1. Liefern
  • Liste zuerst die Oberflächen auf, die du ändern wirst, welche die Linse und die Farbaufteilung erhalten und welche du solide lässt und warum.
  • Füge dann die Token, den Linsen-Helfer und die beiden Einstellungen hinzu, wechsle die Oberflächen um und liste jede Datei auf, die du berührt hast.
  • Ändere kein Layout, keine Schriftarten, keine Radien und keine Texte. Wenn eine Oberfläche eine neue Komponente benötigen würde, um als Glas zu funktionieren, halte an und frage mich zuerst.

Individual skills in this repo

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

kubai-book-cards

卡片在悬停或聚焦时像书一样翻开一定角度,显示里面的内页,静止时外观保持不变。提供普通卡片、拟物精装书和极简文档三种风格。适用于文档、知识库、作品集和模板市场(book hover cards)。

kubai-easing-curves

按使用场景为项目中的动画设置缓动曲线和时长:入场用 ease-out,离场用 ease-in,位置变化用 ease-in-out,小的确认反馈用 overshoot,拖动松手后用 spring,并统一为动效 token(easing, motion curves)。

kubai-holo-card

把产品里代表身份或收藏的卡片(会员卡、门票、徽章、个人卡片)改成镭射卡片:卡片朝指针方向 3D 倾斜,镭射与高光随光线移动,内部图案按深度产生视差,静止时轻微晃动,点击可翻到背面并显示厚度。附 Prism、Rainbow、Pearl、Sparkle、Chrome、Etched 六种材质的推荐参数,以及手感、厚度、翻转和层次的几档预设。开始前逐项询问,每项给出推荐值,由你选择或调整,确认后再按现有技术栈改造(holographic card, foil, 3D tilt, parallax)。

kubai-scroll-cards

改造现有长页面:选出值得讲的段落,用五种由滚动驱动的卡片交互呈现——层叠卡片(新卡片逐张盖住旧卡片,旧卡片缩小、变暗)、卡组飞出(顶部卡片向一侧甩出,下一张顶上来)、横向展廊(页面固定,纵向滚动推动横向作品集)、封面轮播(中间一张最大,两侧缩小、转开、变暗)、图片展开(小图铺满屏幕,标题从景物后升起形成景深)。效果全部由滚动位置驱动,读者控制节奏,回滚即倒放,不劫持滚动;尺寸按不同屏幕和视窗高度计算,手机工具栏不会挡住内容,矮屏自动退回普通段落。附多档预设,开始前逐项询问,由你选择或调整,确认后按现有技术栈实现(scroll-driven animation, sticky, cover flow, svh)。

Verwandte Skills