Communitygithub.com

brainzcode/premium-landing

Construye auténtico vidrio líquido estilo Apple en el navegador — refracción real mediante mapas de desplazamiento SVG, dispersión cromática y bordes especulares.

¿Qué es premium-landing?

Esta skill, `brainzcode/premium-landing`, proporciona una implementación avanzada de vidrio líquido para interfaces web, superando la simple técnica de desenfoque (`backdrop-filter`) que produce un aspecto de plástico opaco. El núcleo de la solución es un filtro SVG (`feDisplacementMap`) que, utilizando un mapa de normales codificado en un degradado SVG, desplaza el fondo en los bordes del elemento manteniendo el centro ópticamente plano, simulando la refracción real del vidrio. Además, implementa dispersión cromática (descomposición de la luz en colores RGB) para un efecto de franja de color en los bordes y un destello especular (Fresnel) para dar realismo. La skill aborda dos problemas críticos: el rendimiento (el `backdrop-filter` puede causar caídas de frames; se ofrece una alternativa con una copia estática del fondo que reduce el costo de filtro a ~1-2%) y la legibilidad del texto sobre vidrio (se proporcionan técnicas para medir el contraste real y aplicar un gradiente de tinte oscuro debajo del texto. Finalmente, incluye reglas de estilo, advertencias sobre máscaras y estrategias de fallback para navegadores no compatibles.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Vidrio Líquido

Lo único que importa

El desenfoque no es refracción. Un desenfoque suaviza el fondo en su lugar. El vidrio lo desplaza: la luz se dobla en el borde y pasa recta por el centro. Si usas backdrop-filter: blur() y lo llamas vidrio líquido, se percibe como plástico esmerilado plano y el usuario te lo hará saber.

El modelo óptico a reproducir (de renderizadores de vidrio reales, ej. estudios WebGL/SDF):

propiedadqué hacecómo obtenerlo en CSS/SVG
RefracciónFondo desplazado en el borde, plano en el centrofeDisplacementMap + un mapa de normales
DispersiónR/G/B se doblan en diferentes cantidades → franjas de color3 pasos de desplazamiento, recombinar un canal cada uno
Fresnel / especularLos bordes atrapan la luzdegradado en el % superior del elemento
DesenfoqueSuavizadofeGaussianBlur, moderado — las formas deben sobrevivir

Solo el primero es innegociable. Sin desplazamiento no es vidrio.

Implementación funcional

El mapa de normales codifica la pendiente de la superficie: R = horizontal, G = vertical, gris medio (128) = plano. Neutro en el centro, aumentando a extremos solo en una banda de bisel — eso es lo que hace que el centro sea ópticamente plano y el borde se doble, como una lente. Usa preserveAspectRatio="none" para que los degradados por eje se estiren correctamente a cualquier tamaño de elemento.

<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"/>

    <!-- dispersión: mismo mapa, tres escalas, un canal conservado de cada uno -->
    <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" es obligatorio — el valor predeterminado linearRGB sesga los valores de desplazamiento y el bisel sale incorrecto.

La convención de gris medio significa que el mapa atrae el contenido hacia adentro desde el interior en cada borde, que es el comportamiento correcto de una lente (magnificación en el borde) y nunca muestra fuera de la región del filtro.

Rendimiento: la trampa que te morderá

backdrop-filter se recalcula en cada fotograma en que el elemento se mueve en el viewport. Medido en una página real: 20% de fotogramas perdidos, picos de 100ms. Y no es la complejidad del filtro — reducir 3 mapas de desplazamiento a 1 y el desenfoque de 9 a 4 solo pasó de 20% a 13%. El simple blur() por sí solo seguía siendo 10%. El ajuste no puede solucionar esto.

Pregunta: ¿el fondo realmente se mueve en relación con el elemento? Si el vidrio y lo que refracta se desplazan juntos (una tarjeta sobre un encabezado, un panel sobre su propia sección), la refracción nunca cambia — así que no la recalcules. Coloca una copia estática del contenido del fondo dentro del elemento y aplica el filtro como un filter normal:

.card {
  position: relative;
  overflow: hidden;
  isolation: isolate;
  background: var(--page-bg);      /* opaco: oculta el fondo real detrás */
}
.card-glass {                       /* contiene una copia de lo que está detrás */
  position: absolute; inset: 0; z-index: 0;
  overflow: hidden; pointer-events: none;
  filter: url(#liquidGlass);        /* filtro en ESTE cuadro, para que el mapa normal
                                       abarque la tarjeta y el bisel caiga en
                                       los bordes de la tarjeta — no en el texto */
}
.card::after {                      /* tinte + especular ENCIMA de la refracción */
  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; }

Alinea la copia con JS al cargar, en document.fonts.ready, y en redimensionamiento (con retardo). Resultado: rasterizado una vez, luego solo composición — el costo del filtro cae a ~1–2%.

Otros hechos de rendimiento, todos medidos:

  • will-change: transform en la capa de vidrio lo empeoró drásticamente (18% → 41%). No recurras a la promoción de capas aquí.
  • Una superposición fija de mix-blend-mode en todo el viewport (grano de película, viñeta) a menudo tiene un costo mayor que el vidrio — obliga al compositor a recombinar toda la pantalla en cada fotograma. Una página midió 34% de fotogramas perdidos; eliminar solo el modo de mezcla (manteniendo la superposición con baja opacidad) lo redujo al 3%. Verifica esto antes de culpar al vidrio.
  • backdrop-filter en un elemento sticky está siempre en pantalla, por lo que paga el costo en cada fotograma de cada desplazamiento. Mantén esos económicos.

Texto sobre vidrio: mide, no calcules a ojo

El vidrio transparente sobre contenido brillante destruye el contraste del texto pequeño. Números reales de una compilación: etiquetas con 1.77 / 2.69 / 2.41 : 1 frente a un requisito de 4.5.

Hacer el texto más blanco lo empeora. Blanco sobre un fondo de luminancia 188 es 1.92:1. El material tiene que ser más oscuro. Aumenta el tinte a máxima intensidad antes de la primera línea de texto — como fracción de la altura del elemento, no como un desplazamiento fijo:

background: linear-gradient(180deg,
  rgba(255,255,255,.14) 0%,     /* brillo especular — este es el "borde" */
  rgba(255,255,255,.03) 2%,
  rgba(11,11,14,.63)   6%,      /* tinte completamente presente antes de la banda de etiquetas */
  rgba(10,10,12,.62)  58%,
  rgba(8,8,10,.70)   100%);

Verifica renderizando con el texto oculto y muestreando el fondo real:

page.add_style_tag(content=".label,.price{visibility:hidden}")
crop = screenshot_region_of(element)
bg = np.percentile(crop.reshape(-1,3), 90, axis=0)   # percentil 90 = peor caso
ratio = wcag_contrast(text_rgb, bg)                   # necesita 4.5 pequeño / 3.0 grande

Muestrea varios fotogramas si el fondo es un video o animación — toma el peor.

Reglas de estilo

  • Sin bordes. El vidrio real tiene un borde especular que atrapa la luz, no un trazo de 1px. Un border: 1px solid se lee como un panel de UI. Usa el 2% superior del degradado.
  • UI oscura = vidrio con tinte oscuro. No dejes que se vuelva blanco.
  • Aumenta la saturación al máximo (180–200%) — el vidrio concentra la luz. Desenfoca moderadamente; un desenfoque fuerte borra las formas que demuestran que es vidrio.
  • Mantén los espacios entre paneles de vidrio adyacentes estrechos (~10px). Un espacio ancho muestra una porción sin desenfocar del fondo y se percibe como un error de renderizado.

Errores comunes con máscaras

  • mask-image crea un contexto de apilamiento. Poner mix-blend-mode en un hijo de un elemento con máscara atrapa la mezcla y el fondo se compone directamente sobre tu contenido. Pon la mezcla en el propio elemento enmascarado.
  • mask-repeat por defecto es repeat. Si los glifos o el contenido desbordan la caja del elemento (ej. line-height < 1 empuja los descendentes hacia afuera), el degradado se repite y vuelve a opaco en el límite — una banda dura que corta tu contenido. no-repeat tampoco lo soluciona: fuera del área de la máscara el alfa es 0, por lo que el desbordamiento desaparece. O dimensiona la máscara para cubrir el desbordamiento, o elimina la máscara.
  • Los radios de máscara radial no deben exceder la distancia al borde más cercano, o la máscara sigue siendo parcialmente opaca donde el elemento se recorta — lo que dibuja el rectángulo duro exacto que intentabas evitar. radial-gradient(50% 50% at 50% 50%, …) llega a cero en los cuatro bordes.

Demostrando que realmente refracta

No confíes en una captura de pantalla. Coloca un patrón de prueba de rayas detrás del vidrio y compara el período de las rayas en el borde versus el centro:

Borde:    30px → 60px   (fondo estirado por la lente)
Centro: 35px → 35px   (ópticamente plano)

Centro sin cambios + borde estirado = refracción real. Cambio uniforme = solo lo desenfocaste. Una verificación rápida de que el desenfoque está haciendo algo: la diferencia media absoluta de píxeles horizontales debería caer bruscamente a través del vidrio (medido 3.31 → 0.74 por px).

Fallbacks

Envuelve la mejora para que los navegadores no compatibles mantengan algo que aún se vea bien:

@supports not ((backdrop-filter: blur(1px)) or (-webkit-backdrop-filter: blur(1px))) {
  .card { background: <degradado opaco>; }   /* translúcido + fondo nítido = roto */
}

El soporte de Safari para filtros SVG (url()) en backdrop-filter es la parte más inestable de toda esta técnica — CSS.supports() puede devolver verdadero sin renderizar correctamente. Prueba en Safari real antes de publicar, y prefiere el enfoque de copia estática (un filter simple, que tiene mucho mejor soporte) cuando el fondo lo permita.

Omite la refracción por completo en pantallas pequeñas si el diseño implica que hay poco fondo que doblar — es puro costo de rasterización sin efecto 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 relacionados