Communitygithub.com

brainzcode/vidrolíquido-premium

Construa vidro líquido ao estilo Apple diretamente no navegador — refração real via mapas de deslocamento SVG, dispersão cromática e bordas especulares. Use quando for solicitado vidro líquido, glassmorphism, cartões de vidro fosco, barras de navegação em vidro ou quando um efeito de "vidro" baseado em desfoque parecer sem profundidade. Inclui as armadilhas de desempenho que fazem o backdrop-filter travar ao rolar e a armadilha de contraste que torna o texto ilegível sobre o vidro.

O que é vidrolíquido-premium?

Esta skill implementa um efeito de vidro líquido realista no navegador, substituindo técnicas simplistas de desfoque (`backdrop-filter: blur()`) por um modelo óptico preciso que utiliza mapas de deslocamento SVG (`feDisplacementMap`) para refração real, dispersão cromática e bordas do tipo Fresnel. Diferente de abordagens comuns que produzem plástico fosco, este efeito simula como a luz se curva nas bordas e passa reta pelo centro — características de lentes e vidro verdadeiros. A skill cobre implementação completa com filtros SVG, otimizações de desempenho (incluindo como evitar quedas de 20%+ de quadros), técnicas para garantir legibilidade de texto sobre vidro (medindo contraste real com Python/Selenium), e armadilhas de mascaramento e fallback. É adequada para desenvolvedores que desejam efeitos visuais de alta fidelidade para landing pages premium, cartões interativos ou navegação em vidro, funcionando em navegadores modernos com suporte a filtros SVG e CSS, com ênfase especial em evitar problemas comuns de desempenho e contraste.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Vidro Líquido

A única coisa que importa

Desfoque não é refração. Um desfoque suaviza o fundo no lugar. O vidro move — a luz se curva nas bordas e passa reta pelo meio. Se você enviar backdrop-filter: blur() e chamar de vidro líquido, ele parece plástico fosco chatíssimo e o usuário vai te dizer isso.

O modelo óptico a reproduzir (de renderizadores de vidro reais, ex. estúdios WebGL/SDF):

propriedadeo que fazcomo obter em CSS/SVG
Refraçãofundo deslocado na borda, plano no centrofeDisplacementMap + mapa normal
DispersãoR/V/B curvam em quantidades diferentes → franjas coloridas3 passos de deslocamento, recombinar um canal cada
Fresnel / especularbordas captam luzgradiente nos primeiros % do elemento
DesfoquesuavizaçãofeGaussianBlur, moderado — as formas devem sobreviver

Apenas o primeiro é inegociável. Sem deslocamento não é vidro.

Implementação funcional

O mapa normal codifica a inclinação da superfície: R = horizontal, G = vertical, cinza-médio (128) = plano. Neutro no meio, variando ao extremo apenas em uma faixa de bisel — isso é o que faz o centro ser opticamente plano e a borda curvar, como uma lente. Use preserveAspectRatio="none" para que gradientes por eixo se estiquem corretamente em qualquer tamanho de elemento.

<svg aria-hidden="true" style="position:absolute;width:0;height:0">
  <filter id="vidroLiquido" x="0%" y="0%" width="100%" height="100%"
          color-interpolation-filters="sRGB" filterUnits="objectBoundingBox">
    <feImage result="mapaNormal" 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"/>

    <!-- dispersão: mesmo mapa, três escalas, um canal mantido de cada -->
    <feDisplacementMap in="SourceGraphic" in2="mapaNormal" scale="42" xChannelSelector="R" yChannelSelector="G" result="rR"/>
    <feDisplacementMap in="SourceGraphic" in2="mapaNormal" scale="48" xChannelSelector="R" yChannelSelector="G" result="rG"/>
    <feDisplacementMap in="SourceGraphic" in2="mapaNormal" 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="disperso"/>

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

color-interpolation-filters="sRGB" é obrigatório — o padrão linearRGB distorce os valores de deslocamento e o bisel fica errado.

A convenção do cinza-médio significa que o mapa puxa o conteúdo para dentro a partir do interior em cada borda, que é o comportamento correto de lente (ampliação na borda) e nunca amostra fora da região do filtro.

Desempenho: a armadilha que vai te pegar

backdrop-filter recalcula a cada quadro em que o elemento se move no viewport. Medido em uma página real: 20% dos quadros perdidos, picos de 100ms. E não é a complexidade do filtro — reduzir 3 mapas de deslocamento para 1 e o desfoque de 9 para 4 só moveu 20% → 13%. Apenas blur() sozinho ainda estava em 10%. Ajuste não resolve isso.

Pergunte: o fundo realmente se move em relação ao elemento? Se o vidro e o que ele refrata rolam juntos (um cartão sobre um título, um painel sobre sua própria seção), a refração nunca muda — então não recalcule. Coloque uma cópia estática do conteúdo do fundo dentro do elemento e aplique o filtro como um filter normal:

.card {
  position: relative;
  overflow: hidden;
  isolation: isolate;
  background: var(--page-bg);      /* opaco: esconde o fundo real atrás */
}
.card-glass {                       /* contém uma cópia do que está atrás */
  position: absolute; inset: 0; z-index: 0;
  overflow: hidden; pointer-events: none;
  filter: url(#vidroLiquido);        /* filtro NESTA caixa, então o mapa normal
                                        abrange o cartão e o bisel fica nas
                                        bordas do cartão — não no texto */
}
.card::after {                      /* tonalidade + especular ACIMA da refração */
  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; }

Alinhe a cópia com JS no carregamento, em document.fonts.ready, e no redimensionamento (com debounce). Resultado: rasterizado uma vez, depois apenas composto — o custo do filtro cai para ~1–2%.

Outros fatos de desempenho, todos medidos:

  • will-change: transform na camada de vidro piorou drasticamente (18% → 41%). Não recorra à promoção de camada aqui.
  • Uma sobreposição fixa de viewport inteiro com mix-blend-mode (grão de filme, vinheta) é frequentemente um custo maior que o vidro — ela força o compositor a re-misturar a tela toda a cada quadro. Uma página medida teve 34% dos quadros perdidos; removendo apenas o modo de mesclagem (mantendo a sobreposição com baixa opacidade) foi para 3%. Verifique isso antes de culpar o vidro.
  • backdrop-filter em um elemento sticky está sempre na tela, então paga o custo em cada quadro de cada rolagem. Mantenha esses leves.

Texto sobre vidro: meça, não confie no olho

Vidro transparente sobre conteúdo claro destrói o contraste de texto pequeno. Números reais de uma construção: rótulos em 1,77 / 2,69 / 2,41 : 1 contra um requisito de 4,5.

Deixar o texto mais branco piora. Branco sobre um fundo de luminância 188 é 1,92:1. O material tem que ser mais escuro. Aumente a tonalidade para força total antes da primeira linha de texto — como fração da altura do elemento, não um deslocamento fixo:

background: linear-gradient(180deg,
  rgba(255,255,255,.14) 0%,     /* fio especular — esta é a "borda" */
  rgba(255,255,255,.03) 2%,
  rgba(11,11,14,.63)   6%,      /* tonalidade totalmente inserida antes da faixa do rótulo */
  rgba(10,10,12,.62)  58%,
  rgba(8,8,10,.70)   100%);

Verifique renderizando com o texto oculto e amostrando o fundo 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)   # 90º percentil = pior caso
ratio = wcag_contrast(text_rgb, bg)                   # precisa 4,5 pequeno / 3,0 grande

Amostre vários quadros se o fundo for um vídeo ou animação — pegue o pior.

Regras de estilo

  • Sem bordas. Vidro real tem uma borda especular que capta luz, não um traço de 1px. Um border: 1px solid parece um painel de UI. Use os 2% superiores do gradiente.
  • UI escura = vidro com tonalidade escura. Não deixe estourar para branco.
  • Aumente a saturação bastante (180–200%) — o vidro concentra luz. Desfoque moderadamente; desfoque pesado apaga as formas que provam que é vidro.
  • Mantenha espaços entre painéis de vidro adjacentes apertados (~10px). Uma lacuna larga mostra um pedaço sem desfoque do fundo e parece um bug de renderização.

Armadilhas de mascaramento

  • mask-image cria um contexto de empilhamento. Colocar mix-blend-mode em um filho de um elemento mascarado prende a mesclagem e o fundo compõe diretamente sobre seu conteúdo. Coloque a mesclagem no próprio elemento mascarado.
  • mask-repeat padrão é repeat. Se glifos ou conteúdo transbordarem a caixa do elemento (ex. line-height < 1 empurra descendentes para fora), o gradiente tiles e volta a opaco na borda — uma faixa dura cortando seu conteúdo. no-repeat também não resolve: fora da área da máscara o alfa é 0, então o transbordamento desaparece. Ou dimensione a máscara para cobrir o transbordamento, ou remova a máscara.
  • Raios de máscara radial não devem exceder a distância até a borda mais próxima, ou a máscara ainda está parcialmente opaca onde o elemento corta — o que desenha o retângulo duro exato que você estava tentando evitar. radial-gradient(50% 50% at 50% 50%, …) chega a zero em todas as quatro bordas.

Provando que realmente refrata

Não confie em uma captura de tela. Coloque um padrão de teste listrado atrás do vidro e compare o período da listra na borda versus o centro:

borda:    30px → 60px   (fundo esticado pela lente)
centro:   35px → 35px   (opticamente plano)

Centro inalterado + borda esticada = refração real. Mudança uniforme = você só desfocou. Uma verificação rápida de que o desfoque está fazendo algo: diferença média absoluta de pixel horizontal deve cair drasticamente através do vidro (medido 3,31 → 0,74 por px).

Fallbacks

Envolva o aprimoramento para que navegadores não suportados mantenham algo que ainda parece certo:

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

O suporte do Safari para filtros SVG (url()) em backdrop-filter é a parte mais instável desta técnica toda — CSS.supports() pode relatar verdadeiro sem renderizar corretamente. Teste no Safari real antes de enviar, e prefira a abordagem de cópia estática acima (um filter simples, que tem suporte muito melhor) quando o fundo permitir.

Pule a refração completamente em telas pequenas se o layout significar que há pouco fundo para curvar — é custo de rasterização puro sem efeito visível.

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.

Habilidades Relacionadas