Communitygithub.com

brainzcode/premium-landing

Baue echtes Liquid Glass im Apple-Stil im Browser – mit Brechung durch SVG-Displacement-Maps, chromatischer Dispersion und spekularen Kanten. Verwende diese Fähigkeit bei Anfragen nach Liquid Glass, Glas-Morphismus, mattierten/Glas-Karten, Glas-Navbars oder wenn ein blur-basierter 'Glas'-Effekt flach wirkt. Enthält die Performance-Falle, die backdrop-filter beim Scrollen ins Stottern bringt, und die Kontrastfalle, die Text auf Glas unlesbar macht.

Was ist premium-landing?

Diese Fähigkeit ermöglicht es Entwicklern, echte flüssige Glaseffekte (Liquid Glass) im Apple-Stil direkt im Browser zu erzeugen. Der Kern liegt darin, dass einfaches `backdrop-filter: blur()` nur eine Unschärfe erzeugt und nicht die physikalisch korrekte Lichtbrechung von Glas simuliert. Die Implementierung verwendet stattdessen ein SVG `feDisplacementMap`-Filter mit einer Normal Map, um die Verschiebung des Hintergrunds an den Rändern des Elements zu erzeugen, während die Mitte optisch flach bleibt. Zusätzlich wird durch drei separate Displacement-Pässe chromatische Dispersion (Farbaufspaltung) simuliert, und ein Fresnel-Effekt sorgt für glänzende Ränder. Die Fähigkeit ist plattformunabhängig und kann in jedem modernen Browser eingesetzt werden, der SVG-Filter unterstützt. Sie adressiert zwei kritische Fallstricke: Erstens die Performance: `backdrop-filter` berechnet bei jedem Frame neu und kann zu 20% verlorenen Frames führen. Als Lösung wird eine statische Kopie des Hintergrunds im Element empfohlen, auf die der Filter nur einmal angewendet wird. Zweitens die Lesbarkeit: Transparentes Glas über hellem Inhalt zerstört den Kontrast von kleinem Text. Die Fähigkeit bietet eine Methode, die Tönung des Glases zu berechnen, um den WCAG-Kontrast von 4.5:1 für kleinen Text zu erreichen, sowie ein Python-Snippet zur Überprüfung. Zusätzlich enthält sie präzise Styling-Regeln (keine Ränder, dunkle UI mit getöntem Glas, hohe Sättigung) und Warnungen zu häufigen Fehlern mit Masken und Farbinterpolation.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/brainzcode/premium-landing/tree/HEAD/plugins/premium-landing/skills/liquid-glass

In Ihrer bevorzugten KI fragen

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

Dokumentation

Liquid Glass

Das Einzige, was zählt

Unschärfe ist keine Brechung. Eine Weichzeichnung verwischt den Hintergrund an Ort und Stelle. Glas bewegt ihn – Licht wird am Rand gebrochen und geht in der Mitte gerade durch. Wenn du backdrop-filter: blur() auslieferst und es Liquid Glass nennst, wirkt es wie flaches, mattiertes Plastik, und der Nutzer wird dir das sagen.

Das optische Modell, das nachgebildet werden muss (aus echten Glas-Renderern, z.B. WebGL/SDF-Studios):

EigenschaftFunktionUmsetzung in CSS/SVG
Brechung (Refraktion)Hintergrund am Rand verschoben, in der Mitte flachfeDisplacementMap + eine Normal Map
DispersionR/G/B werden unterschiedlich stark gebogen → Farbsäume3 Displacement-Pässe, jeweils ein Kanal pro Pass rekonstruiert
Fresnel / spekularKanten fangen LichtVerlauf auf den oberen % des Elements
Unschärfe (Blur)WeichzeichnungfeGaussianBlur, moderat – Formen müssen erhalten bleiben

Nur der erste Punkt ist nicht verhandelbar. Ohne Verschiebung ist es kein Glas.

Funktionierende Implementierung

Die Normal Map kodiert die Oberflächenneigung: R = horizontal, G = vertikal, Mittelgrau (128) = flach. Neutral in der Mitte, Übergang zu den Extremen nur in einer schmalen Fase – das macht die Mitte optisch flach und den Rand brechend, wie eine Linse. Verwende preserveAspectRatio="none", damit sich achsenspezifische Verläufe korrekt an jede Elementgröße anpassen.

<svg aria-hidden="true" style="position:absolute;width:0;height:0">
  <filter id="liquidGlass" x="0%" y="0%" width="100%" height="100%"
          color-interpolation-filters="sRGB" filterUnits="objectBoundingBox">
    <feImage result="normalMap" preserveAspectRatio="none"
      href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='100' height='100' viewBox='0 0 100 100' preserveAspectRatio='none'%3E%3Cdefs%3E%3ClinearGradient id='h' x1='0' y1='0' x2='1' y2='0'%3E%3Cstop offset='0' stop-color='rgb(255,0,0)'/%3E%3Cstop offset='.035' stop-color='rgb(205,0,0)'/%3E%3Cstop offset='.10' stop-color='rgb(128,0,0)'/%3E%3Cstop offset='.90' stop-color='rgb(128,0,0)'/%3E%3Cstop offset='.965' stop-color='rgb(51,0,0)'/%3E%3Cstop offset='1' stop-color='rgb(0,0,0)'/%3E%3C/linearGradient%3E%3ClinearGradient id='v' x1='0' y1='0' x2='0' y2='1'%3E%3Cstop offset='0' stop-color='rgb(0,255,0)'/%3E%3Cstop offset='.035' stop-color='rgb(0,205,0)'/%3E%3Cstop offset='.10' stop-color='rgb(0,128,0)'/%3E%3Cstop offset='.90' stop-color='rgb(0,128,0)'/%3E%3Cstop offset='.965' stop-color='rgb(0,51,0)'/%3E%3Cstop offset='1' stop-color='rgb(0,0,0)'/%3E%3C/linearGradient%3E%3C/defs%3E%3Crect width='100' height='100' fill='url(%23h)'/%3E%3Crect width='100' height='100' fill='url(%23v)' style='mix-blend-mode:screen'/%3E%3C/svg%3E"/>

    <!-- Dispersion: dieselbe Map, drei Skalierungen, ein Kanal aus jeder beibehalten -->
    <feDisplacementMap in="SourceGraphic" in2="normalMap" scale="42" xChannelSelector="R" yChannelSelector="G" result="rR"/>
    <feDisplacementMap in="SourceGraphic" in2="normalMap" scale="48" xChannelSelector="R" yChannelSelector="G" result="rG"/>
    <feDisplacementMap in="SourceGraphic" in2="normalMap" scale="54" xChannelSelector="R" yChannelSelector="G" result="rB"/>
    <feColorMatrix in="rR" values="1 0 0 0 0  0 0 0 0 0  0 0 0 0 0  0 0 0 1 0" result="cR"/>
    <feColorMatrix in="rG" values="0 0 0 0 0  0 1 0 0 0  0 0 0 0 0  0 0 0 1 0" result="cG"/>
    <feColorMatrix in="rB" values="0 0 0 0 0  0 0 0 0 0  0 0 1 0 0  0 0 0 1 0" result="cB"/>
    <feBlend in="cR" in2="cG" mode="screen" result="rg"/>
    <feBlend in="rg" in2="cB" mode="screen" result="dispersed"/>

    <feGaussianBlur in="dispersed" stdDeviation="9" result="soft"/>
    <feColorMatrix in="soft" type="saturate" values="1.9"/>
  </filter>
</svg>

color-interpolation-filters="sRGB" ist Pflicht – die Voreinstellung linearRGB verfälscht die Verschiebungswerte und die Fase wird falsch.

Die Mittelgrau-Konvention bedeutet, dass die Map den Inhalt an jeder Kante nach innen zieht, was korrektes Linsenverhalten ist (Vergrößerung am Rand) und niemals außerhalb des Filterbereichs sampelt.

Performance: Die Falle, die dich beißen wird

backdrop-filter berechnet jeden Frame neu, wenn sich das Element durch den Viewport bewegt. Gemessen auf einer echten Seite: 20% verlorene Frames, 100ms Spitzen. Und es liegt nicht an der Filterkomplexität – die Reduzierung von 3 Displacement-Maps auf 1 und der Unschärfe von 9 auf 4 verschob nur 20% → 13%. Ein einfaches blur() allein lag immer noch bei 10%. Optimierung kann das nicht beheben.

Frage: Bewegt sich der Hintergrund tatsächlich relativ zum Element? Wenn das Glas und das, was es bricht, zusammen scrollen (eine Karte über einer Überschrift, ein Panel über seinem eigenen Bereich), ändert sich die Brechung nie – also berechne sie nicht neu. Lege eine statische Kopie des Hintergrundinhalts innerhalb des Elements an und wende den Filter als normalen filter an:

.card {
  position: relative;
  overflow: hidden;
  isolation: isolate;
  background: var(--page-bg);      /* deckend: versteckt den echten Hintergrund dahinter */
}
.card-glass {                       /* enthält eine Kopie von dem, was dahinter ist */
  position: absolute; inset: 0; z-index: 0;
  overflow: hidden; pointer-events: none;
  filter: url(#liquidGlass);        /* Filter auf DIESER Box, sodass die Normal Map
                                       die Karte überspannt und die Fase auf den
                                       Kanten der Karte landet – nicht auf dem Text */
}
.card::after {                      /* Tönung + Spekular ÜBER der Brechung */
  content: ""; position: absolute; inset: 0; z-index: 1;
  border-radius: inherit; pointer-events: none;
  background: linear-gradient(180deg, …);
}
.card > *:not(.card-glass) { position: relative; z-index: 2; }

Richte die Kopie mit JS beim Laden, bei document.fonts.ready und bei Größenänderung (entprellt) aus. Ergebnis: Einmal gerastert, dann nur noch zusammengesetzt – die Filterkosten sinken auf etwa 1–2%.

Weitere Performance-Fakten, alle gemessen:

  • will-change: transform auf der Glas-Schicht hat es dramatisch verschlechtert (18% → 41%). Greife hier nicht zur Layer-Promotion.
  • Ein fester, den gesamten Viewport bedeckender mix-blend-mode-Overlay (Filmkörnung, Vignette) ist oft teurer als das Glas – er zwingt den Compositor, das gesamte Display jeden Frame neu zu mischen. Eine Seite maß 34% verlorene Frames; das alleinige Entfernen des Blend-Modus (bei gleichbleibend niedriger Deckkraft des Overlays) brachte es auf 3%. Überprüfe dies, bevor du dem Glas die Schuld gibst.
  • backdrop-filter auf einem sticky Element ist immer auf dem Bildschirm, also wird die Kosten bei jedem Frame eines jeden Scrollvorgangs fällig. Halte solche Elemente günstig.

Text auf Glas: Messen, nicht schätzen

Transparentes Glas über hellem Inhalt zerstört den Kontrast von kleinem Text. Reale Zahlen aus einem Build: Labels bei 1.77 / 2.69 / 2.41 : 1 gegenüber einer Anforderung von 4.5.

Den Text weißer zu machen, macht es schlimmer. Weiß auf einem Hintergrund mit einer Leuchtdichte von 188 ergibt 1.92:1. Das Material muss dunkler sein. Verstärke die Tönung auf volle Stärke vor der ersten Textzeile – als Bruchteil der Elementhöhe, nicht als festen Offset:

background: linear-gradient(180deg,
  rgba(255,255,255,.14) 0%,     /* spekularer Strich – das ist die "Kante" */
  rgba(255,255,255,.03) 2%,
  rgba(11,11,14,.63)   6%,      /* Tönung vollständig vor dem Label-Bereich */
  rgba(10,10,12,.62)  58%,
  rgba(8,8,10,.70)   100%);

Verifiziere durch Rendern mit verstecktem Text und Sample des echten Hintergrunds:

page.add_style_tag(content=".label,.price{visibility:hidden}")
crop = screenshot_region_of(element)
bg = np.percentile(crop.reshape(-1,3), 90, axis=0)   # 90. Perzentil = schlechtester Fall
ratio = wcag_contrast(text_rgb, bg)                   # benötigt 4.5 klein / 3.0 groß

Sample mehrere Frames, wenn der Hintergrund ein Video oder eine Animation ist – nimm den schlechtesten.

Styling-Regeln

  • Keine Ränder. Echtes Glas hat eine lichtfangende spekulare Kante, keinen 1px Strich. Ein border: 1px solid wirkt wie ein UI-Panel. Verwende die oberen 2% des Verlaufs.
  • Dunkle UI = dunkel getöntes Glas. Lass es nicht ins Weiße ausbluten.
  • Hohe Sättigung (180–200%) – Glas konzentriert Licht. Unschärfe moderat; starke Unschärfe löscht die Formen, die beweisen, dass es Glas ist.
  • Halte Abstände zwischen benachbarten Glas-Panels eng (~10px). Ein großer Abstand zeigt einen unscharfen Streifen des Hintergrunds und wirkt wie ein Rendering-Fehler.

Fallstricke bei Masken

  • mask-image erzeugt einen Stapelkontext. Wenn mix-blend-mode auf einem Kind eines maskierten Elements platziert wird, fängt es den Blend ein und der Hintergrund legt sich direkt über deinen Inhalt. Setze den Blend auf das maskierte Element selbst.
  • mask-repeat standardmäßig repeat. Wenn Glyphen oder Inhalt über den Element-Box hinausragen (z.B. line-height < 1 drückt Unterlängen heraus), kachelt der Verlauf und springt an der Grenze zurück zu deckend – ein harter Balken, der durch deinen Inhalt schneidet. no-repeat behebt es auch nicht: Außerhalb des Maskenbereichs ist Alpha 0, sodass der Überlauf stattdessen verschwindet. Entweder die Maskengröße anpassen, um den Überlauf abzudecken, oder die Maske weglassen.
  • Radiale Maskenradien dürfen den Abstand zur nächsten Kante nicht überschreiten, sonst ist die Maske dort, wo das Element abgeschnitten wird, noch teilweise deckend – was genau das harte Rechteck zeichnet, das du vermeiden wolltest. radial-gradient(50% 50% at 50% 50%, …) erreicht auf allen vier Seiten null.

Nachweis, dass es tatsächlich bricht

Vertraue keinem Screenshot. Lege ein gestreiftes Testmuster hinter das Glas und vergleiche die Streifen-Periode am Rand mit der Mitte:

Rand:    30px → 60px   (Hintergrund durch die Linse gestreckt)
Mitte:   35px → 35px   (optisch flach)

Unveränderte Mitte + gestreckter Rand = echte Brechung. Gleichmäßige Änderung = du hast nur unscharf gemacht. Ein schneller Check, ob die Unschärfe überhaupt etwas tut: Der mittlere absolute horizontale Pixelunterschied sollte durch das Glas stark abfallen (gemessen 3.31 → 0.74 pro px).

Fallbacks

Verpacke die Verbesserung, sodass nicht unterstützende Browser etwas behalten, das trotzdem richtig aussieht:

@supports not ((backdrop-filter: blur(1px)) or (-webkit-backdrop-filter: blur(1px))) {
  .card { background: <deckender Verlauf>; }   /* durchscheinend + scharfer Hintergrund = kaputt */
}

Safaris Unterstützung für SVG (url()) Filter in backdrop-filter ist der wackeligste Teil dieser gesamten Technik – CSS.supports() kann true melden, ohne korrekt zu rendern. Teste auf echtem Safari vor dem Ausliefern und bevorzuge den oben beschriebenen Ansatz mit statischer Kopie (ein einfacher filter, der weit besser unterstützt wird), wenn es der Hintergrund erlaubt.

Überspringe die Brechung auf kleinen Bildschirmen vollständig, wenn das Layout bedeutet, dass nur wenig Hintergrund zu biegen ist – es ist reine Rasterkosten ohne sichtbaren Effekt.

Individual skills in this repo

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

brainzcode/premium-landing

Add a studio or agency build credit to a website footer — "Site by <Studio>" linking to the studio's site. Use when finishing or shipping a site, adding a footer, or when asked for an agency credit, build credit, designed-by line, or attribution. Covers wording, placement opposite the client's copyright, markup for each stack, styling from the host site's tokens, and the sitewide-footer-link SEO footprint when the same credit runs across many client sites.

brainzcode/premium-landing

Build a complete premium landing page, either replicated from a reference screenshot/URL or designed from a written brief, in HTML, React, Next.js or Astro. Use when asked to build, design, replicate or clone a landing page, marketing page, or one-page site; when handed a design screenshot or Figma/Pinterest reference to turn into code; or when a landing page needs a full premium pass. Covers design tokens, section patterns, the layout traps that silently break grids and marquees, and screenshot-based responsive verification from 320px to 1920px.

brainzcode/premium-landing

Add Lenis smooth scrolling to a site correctly — setup, anchor offsets for sticky headers, scroll locking for modals and menus, reduced-motion handling. Use when asked for smooth scroll, Lenis, momentum/eased scrolling, or when smooth scroll broke a sticky header, a modal lock, or anchor links. Includes the sticky-position trap that only appears at non-zero scroll.

brainzcode/premium-landing

Build a premium mobile nav — a hamburger button that morphs into a close X, a full-screen overlay panel with staggered link reveal, scroll lock, focus trap, and reduced-motion handling. Use when asked for a mobile menu, hamburger/burger button, nav drawer, off-canvas menu, or when a menu loses scroll position, still scrolls behind on iOS, leaks Tab focus to the page underneath, or the close button stops responding. Includes the z-index trap that swallows the close button and the iOS rubber-band trap.

brainzcode/premium-landing

Rebuild a design accurately from a supplied reference — a screenshot, PDF page, mockup or live URL — by measuring it numerically instead of eyeballing it. Use when asked to replicate, clone, match or rebuild a design "exactly", "1 to 1" or "with no mistakes", or when a build drifts from its reference. Covers extracting the true content box from a padded screenshot, deriving element positions as percentages, solving object-fit framing, and knowing when a reference cannot be matched.

brainzcode/premium-landing

Ship link previews and favicons that actually work - Open Graph and Twitter card tags, a correctly framed 1200x630 share image, and a full favicon set (SVG, ICO, apple-touch, maskable manifest icons). Use when asked for social sharing, OG image, open graph, twitter card, link preview, share image, favicon, app icon, apple touch icon, or web manifest. Also use when a shared link previews blank, shows the wrong image, or a favicon will not appear. Includes the absolute-URL trap that silently blanks every preview and the font trap that breaks SVG favicons on other machines.

brainzcode/premium-landing

Source free, licence-clear photography for a site from Unsplash — searching by mood rather than noun, sizing and cropping for the slot, honouring the API's hotlink and download-tracking requirements, and writing real alt text. Use when a page needs a hero image, section photography, avatars or card art and none was supplied; when placeholder greys need replacing with real imagery; or when asked to find, pick or swap photos for a design.

Verwandte Skills