Communitygithub.com

brainzcode/premium-landing

Créez un véritable verre liquide à la Apple dans le navigateur — réfraction via des cartes de déplacement SVG, dispersion chromatique, bords spéculaires. À utiliser pour les interfaces en verre liquide, le glassmorphisme, les cartes givrées, les barres de navigation en verre, ou quand un effet de flou « verre » semble plat. Comprend les pièges de performance et de contraste.

Qu'est-ce que premium-landing ?

Cette compétence fournit une implémentation complète et haute fidélité d’un effet de verre liquide (liquid glass) pour le web, basée sur des filtres SVG, dépassant le simple `backdrop-filter: blur()`. Elle reproduit optiquement la réfraction (déplacement du fond par une carte de normales), la dispersion chromatique (séparation des canaux RGB) et les reflets spéculaires (Fresnel). L’explication détaille la construction d’une carte de normales avec des dégradés linéaires, puis l’utilisation de trois passes de `feDisplacementMap` et de matrices de couleurs pour recombiner les canaux, produisant un effet de verre réaliste où le centre reste plat et les bords dévient la lumière. Un guide de performance crucial montre que `backdrop-filter` peut faire chuter les images par seconde de 20 %, et propose une alternative statique (copie du fond) qui réduit le coût à ~1–2 %. Les pièges de contraste sont aussi traités : le verre transparent rend le texte illisible (contraste mesuré à 1.77:1), et la solution consiste à assombrir la teinte avant la première ligne de texte. La compétence inclut des règles de style (pas de bordure, saturation poussée), des mises en garde sur le masking, une méthode pour vérifier la réfraction réelle, et des fallbacks pour les navigateurs non supportés. C’est un outil destiné aux développeurs front-end maîtrisant CSS/SVG, compatible avec tous les navigateurs modernes (avec une attention particulière pour Safari).

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Verre liquide

La seule chose qui compte

Le flou n'est pas la réfraction. Un flou adoucit l'arrière-plan sur place. Le verre le déplace — la lumière se courbe sur les bords et passe droit au milieu. Si vous livrez backdrop-filter: blur() en l'appelant verre liquide, cela ressemble à du plastique givré plat et l'utilisateur vous le dira.

Le modèle optique à reproduire (d'après les moteurs de rendu de verre réels, ex. WebGL/SDF) :

PropriétéEffetComment l'obtenir en CSS/SVG
RéfractionArrière-plan déplacé sur les bords, plat au centrefeDisplacementMap + carte de normales
DispersionLes canaux R/V/B se courbent différemment → franges colorées3 passes de déplacement, recombiner un canal chacune
Fresnel / spéculaireLes bords captent la lumièreDégradé sur les premiers % de l'élément
FlouAdoucissementfeGaussianBlur, modéré — les formes doivent survivre

Seul le premier est non négociable. Sans déplacement, ce n'est pas du verre.

Implémentation fonctionnelle

La carte de normales encode la pente de la surface : R = horizontal, V = vertical, gris moyen (128) = plat. Neutre au milieu, progressant vers les extrêmes uniquement dans une bande de biseau — c'est ce qui rend le centre optiquement plat et le bord incurvé, comme une lentille. Utilisez preserveAspectRatio="none" pour que les dégradés par axe s'étirent correctement à n'importe quelle taille d'élément.

<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 : même carte, trois échelles, un canal conservé de chacune -->
    <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" est obligatoire — la valeur par défaut linearRGB fausse les valeurs de déplacement et le biseau sera incorrect.

La convention du gris moyen signifie que la carte tire le contenu vers l'intérieur depuis l'intérieur sur chaque bord, ce qui est le comportement correct d'une lentille (magnification sur le bord) et n'échantillonne jamais en dehors de la région du filtre.

Performance : le piège qui vous mordra

backdrop-filter recalcule à chaque frame lorsque l'élément se déplace dans le viewport. Mesuré sur une page réelle : 20 % d'images perdues, pics de 100 ms. Et ce n'est pas la complexité du filtre — passer de 3 cartes de déplacement à 1 et le flou de 9 à 4 n'a déplacé que 20 % → 13 %. Un simple blur() seul était encore à 10 %. L'optimisation ne peut pas résoudre cela.

Demandez : l'arrière-plan bouge-t-il réellement par rapport à l'élément ? Si le verre et ce qu'il réfracte défilent ensemble (une carte au-dessus d'un titre, un panneau au-dessus de sa propre section), la réfraction ne change jamais — ne la recalculez pas. Placez une copie statique du contenu de l'arrière-plan à l'intérieur de l'élément et appliquez le filtre comme un filter normal :

.card {
  position: relative;
  overflow: hidden;
  isolation: isolate;
  background: var(--page-bg);      /* opaque : cache le véritable arrière-plan */
}
.card-glass {                       /* contient une copie de ce qui est derrière */
  position: absolute; inset: 0; z-index: 0;
  overflow: hidden; pointer-events: none;
  filter: url(#liquidGlass);        /* filtre sur CETTE boîte, donc la carte de normales
                                       couvre la carte et le biseau se place sur
                                       les bords de la carte — pas sur le texte */
}
.card::after {                      /* teinte + spéculaire AU-DESSUS de la réfraction */
  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; }

Alignez la copie avec JS au chargement, sur document.fonts.ready, et au redimensionnement (débouncé). Résultat : rastérisé une fois, puis simplement composité — le coût du filtre chute à ~1–2 %.

Autres faits de performance, tous mesurés :

  • will-change: transform sur la couche de verre l'a considérablement aggravé (18 % → 41 %). N'utilisez pas la promotion de couche ici.
  • Une superposition fixe en plein viewport avec mix-blend-mode (grain de film, vignette) coûte souvent plus cher que le verre — elle force le compositeur à re-mélanger tout l'écran à chaque frame. Une page mesurait 34 % d'images perdues ; la simple suppression du mode de fusion (en gardant la superposition à faible opacité) l'a ramenée à 3 %. Vérifiez cela avant d'accuser le verre.
  • backdrop-filter sur un élément sticky est toujours à l'écran, donc il paie le coût à chaque frame de chaque défilement. Gardez-les légers.

Texte sur le verre : mesurez, ne regardez pas

Le verre transparent sur un contenu lumineux détruit le contraste des petits textes. Chiffres réels d'un build : étiquettes à 1,77 / 2,69 / 2,41 : 1 par rapport à une exigence de 4,5.

Rendre le texte plus blanc aggrave le problème. Du blanc sur un arrière-plan de luminance 188 donne 1,92:1. Le matériau doit être plus sombre. Augmentez la teinte à pleine force avant la première ligne de texte — en fraction de la hauteur de l'élément, pas un décalage fixe :

background: linear-gradient(180deg,
  rgba(255,255,255,.14) 0%,     /* éclat spéculaire — c'est le "bord" */
  rgba(255,255,255,.03) 2%,
  rgba(11,11,14,.63)   6%,      /* teinte pleine avant la bande d'étiquettes */
  rgba(10,10,12,.62)  58%,
  rgba(8,8,10,.70)   100%);

Vérifiez en rendant avec le texte caché et en échantillonnant le véritable arrière-plan :

page.add_style_tag(content=".label,.price{visibility:hidden}")
crop = screenshot_region_of(element)
bg = np.percentile(crop.reshape(-1,3), 90, axis=0)   # 90e percentile = pire cas
ratio = wcag_contrast(text_rgb, bg)                   # besoin de 4.5 petit / 3.0 grand

Échantillonnez plusieurs images si l'arrière-plan est une vidéo ou une animation — prenez le pire.

Règles de style

  • Pas de bordures. Le vrai verre a un bord spéculaire qui capte la lumière, pas un trait de 1px. Une border: 1px solid ressemble à un panneau d'interface. Utilisez les 2 % supérieurs du dégradé.
  • UI sombre = verre teinté sombre. Ne le laissez pas devenir blanc.
  • Poussez la saturation fort (180–200 %) — le verre concentre la lumière. Flou modéré ; un flou lourd efface les formes qui prouvent que c'est du verre.
  • Gardez les espaces entre les panneaux de verre adjacents serrés (~10 px). Un large espace montre une tranche non floue de l'arrière-plan et ressemble à un bug de rendu.

Pièges du masquage

  • mask-image crée un contexte d'empilement. Mettre mix-blend-mode sur un enfant d'un élément masqué emprisonne le mode de fusion et l'arrière-plan se compose directement par-dessus votre contenu. Placez le mode de fusion sur l'élément masqué lui-même.
  • mask-repeat par défaut est repeat. Si les glyphes ou le contenu débordent de la boîte de l'élément (ex. line-height < 1 pousse les jambages vers le bas), le dégradé carrelle et revient brusquement à opaque à la limite — une bande dure tranchant votre contenu. no-repeat ne résout pas non plus le problème : en dehors de la zone du masque, l'alpha est 0, donc le débordement disparaît. Soit dimensionnez le masque pour couvrir le débordement, soit supprimez le masque.
  • Les rayons du masque radial ne doivent pas dépasser la distance au bord le plus proche, sinon le masque est encore partiellement opaque là où l'élément se coupe — ce qui dessine le rectangle dur exact que vous cherchiez à éviter. radial-gradient(50% 50% at 50% 50%, …) atteint zéro sur les quatre bords.

Prouver qu'elle réfracte réellement

Ne vous fiez pas à une capture d'écran. Placez un motif de test à rayures derrière le verre et comparez la période des rayures sur le bord par rapport au centre :

bord :   30 px → 60 px   (arrière-plan étiré par la lentille)
centre : 35 px → 35 px   (optiquement plat)

Centre inchangé + bord étiré = vraie réfraction. Changement uniforme = vous l'avez seulement flouté. Une vérification rapide que le flou fait quelque chose : la différence de pixels horizontale moyenne absolue devrait chuter fortement à travers le verre (mesuré 3,31 → 0,74 par px).

Alternatives

Encapsulez l'amélioration pour que les navigateurs non supportés conservent quelque chose de correct :

@supports not ((backdrop-filter: blur(1px)) or (-webkit-backdrop-filter: blur(1px))) {
  .card { background: <dégradé opaque>; }   /* translucide + arrière-plan net = cassé */
}

Le support par Safari des filtres SVG (url()) dans backdrop-filter est la partie la plus fragile de toute cette technique — CSS.supports() peut renvoyer vrai sans que le rendu soit correct. Testez sur un vrai Safari avant de livrer, et préférez l'approche de copie statique ci-dessus (un simple filter, bien mieux supporté) lorsque l'arrière-plan le permet.

Sautez entièrement la réfraction sur les petits écrans si la disposition signifie qu'il y a peu d'arrière-plan à courber — c'est un pur coût de rastérisation pour aucun effet visible.

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.

Skills associés