Communitygithub.com

kubai-liquid-glass

Adicione um material de vidro líquido a cartões e painéis sobre imagens, papéis de parede ou vídeos: desfoque e brilho de fundo, refração e dispersão nas bordas, cores e texto que se ajustam automaticamente ao fundo, legível em modos claro e escuro, sem alterar o layout (vidro líquido, glassmorfismo).

O que é kubai-liquid-glass?

Este skill implementa um material de vidro líquido de alta qualidade para superfícies de UI que ficam sobre imagens, vídeos ou fundos complexos. Ele cria um efeito de vidro espesso que se adapta dinamicamente ao conteúdo atrás, com refração e dispersão de cores nas bordas, mantendo o texto legível tanto em modo claro quanto escuro. O skill funciona definindo um conjunto de tokens de design (variáveis CSS) para os estados claro e escuro, que controlam a tonalidade, o desfoque, a saturação e o brilho. A superfície 'opta' por esses tokens, mantendo a marcação e o layout existentes. Um mapa de deslocamento para as bordas cria o efeito de lente, e a cor do texto é determinada amostrando o brilho do fundo. É útil para desenvolvedores que desejam adicionar um toque de qualidade premium a produtos com interfaces sobrepostas, como players de mídia, barras de ferramentas, menus e popovers. O skill suporta qualquer plataforma web (Chromium), com fallback para Firefox, e prioriza acessibilidade e desempenho. O processo é iterativo: primeiro o skill lista as superfícies que serão modificadas, depois aplica os tokens e o helper de lente, e pergunta ao usuário antes de criar novos componentes se necessário.

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

Perguntar na sua IA favorita

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

Documentação

Material de Vidro Líquido

《999 Pequenas Dicas para Dar Mais Qualidade ao seu Produto Vibe》Ep. 010 · @kubai087

No projeto do usuário, faça as modificações conforme as instruções abaixo. As instruções devem ser escritas na perspectiva do usuário: "I", "me", "my" referem-se ao usuário; onde estiver escrito "pergunte primeiro", pare e pergunte ao usuário antes de continuar.

Requisitos de Modificação

Adicione um material de vidro líquido aos cartões e painéis do meu produto: vidro transparente que pega a cor da cena atrás, parece uma placa grossa nas bordas, adapta-se ao fundo e mantém o texto legível em modo claro e escuro. Trabalhe dentro do meu sistema de design existente. Isto é uma mudança de superfície, não de layout: mantenha minha marcação, espaçamentos, raios, fontes, ícones e textos.

  1. Comece a partir do que existe
  • Encontre toda superfície que fica sobre uma imagem, papel de parede, vídeo ou fundo complexo: cartões, players, barras de busca, barras de ferramentas, menus, popovers, toasts. Liste-as com seus componentes e localizações.
  • Descubra como o produto alterna entre modo claro e escuro, e onde estão seus tokens de cor. O vidro deve ser aplicado nesses tokens, não em cada componente.
  • Deixe superfícies sobre um fundo liso como estão; vidro sobre uma cor sólida parece apenas cinza.
  1. O material como tokens Construa como um conjunto de variáveis por estado, para que uma superfície opte por usá-las. Os números são um ponto de partida, para uma UI de tamanho normal.
  • Vidro claro, texto escuro (padrão): tonalidade branca de 6–22% (por densidade, passo 4); filtro de desfoque de fundo blur(2px) saturate(180%) brightness(1.06), para que a cor venha de trás e permaneça vívida em vez de leitosa. Borda: 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%. Luz interna, em uma camada dentro da superfície: um destaque radial do canto superior esquerdo (branco 30% desbotando para 55%), e brilhos suaves embutidos logo dentro da borda, mais claros no topo e à esquerda, um pouco de sombra no fundo.
  • Modo claro sobre área escura, texto claro: tonalidade rgb(16 18 22) de 10–30%; filtro blur(2px) saturate(170%), depois brightness(0.85); borda: uma linha branca embutida fraca no topo e um contorno escuro de 0.5px.
  • Modo escuro: tonalidade rgb(20 20 24) de 16–38%; filtro blur(2px) saturate(160%) brightness(0.8), que escurece como um multiplicador com preto em vez de ficar turvo; a mesma borda e luz interna com cerca de um terço da intensidade, com um contorno e sombra mais escuros.
  • Tinta, uma cor em etapas fixas, usada para tudo desenhado sobre o vidro: sobre vidro claro: preto 86% (títulos, ícones, horários, progresso), rgb(60 60 67) a 70% (secundário); mix-blend-mode: multiply; sobre vidro escuro: branco 94%, rgb(235 235 245) a 64%; mix-blend-mode: plus-lighter. Desenhe ícones na cor opaca e desbote o ícone inteiro com opacidade: uma cor translúcida escurece onde traços e preenchimentos das formas se sobrepõem.
  • Uma linha destacada sobre vidro claro é uma camada mais clara do vidro: branco 42% ao passar o mouse, 76% quando selecionado, com um traço branco. Nunca um tom cinza.
  • Registre os tokens numéricos e de cor com @property para que uma superfície transite suavemente entre estados, sem saltos.
  1. Aplique em quatro declarações Cada superfície altera apenas estas, e sua marcação permanece como está:
  • background: a tonalidade.
  • backdrop-filter: o filtro do material, depois a lente da borda (passo 3) por último, para que as etapas de cor se fundam em uma passagem e a curvatura permaneça nítida.
  • box-shadow: a borda.
  • color: a tinta, com o modo de mesclagem em tudo desenhado dentro. Ao passar o mouse, a tonalidade clareia cerca de 14% em vez de levantar uma sombra.
  1. A lente da borda
  • Construa um mapa de deslocamento para cada superfície: vermelho é a curvatura lateral, verde a vertical, 128 é nenhum. Apenas a borda curva; o centro permanece plano.
  • A borda tem cerca de 44px de largura em um cartão (min(44px, lado curto / 3.5), nunca abaixo de 4px). Para uma placa grossa, um ponto d da borda olha para dentro por 1.1 × borda × (1 - d / borda)^2.6: forte na borda, onde a cena se dobra sobre si mesma, suavizando até nada na borda interna.
  • Desenhe o mapa para o mesmo canto que o CSS desenha. Se a superfície usa corner-shape: superellipse(), siga essa curva, não um círculo, ou a curvatura e a luz da borda se desencontrarão nos cantos.
  • Coloque-o em um filtro SVG com feImage (o mapa) e feDisplacementMap (escala = 2 × o maior deslocamento), e adicione url(#id) ao final de backdrop-filter.
  • Divida em cores: três passagens, vermelho 15% mais e azul 15% menos, cada um mantido em seu canal com feColorMatrix e adicionado de volta com mesclagens de tela. Verifique os cantos de bordas largas sobre fundos complexos; reduza a divisão onde se transformar em névoa.
  • Apenas Chromium renderiza url() em backdrop-filter. Verifique CSS.supports('backdrop-filter', 'url(#a)') e pule Firefox, que analisa e não renderiza nada. Em outros lugares, o vidro CSS permanece.
  • Aguarde a imagem do mapa decodificar antes de apontar uma superfície para o filtro, ou ela renderizará sem o desfoque. Dê a cada filtro um id único e seu próprio <svg>. Construa mapas uma vez por raio e largura de borda e reutilize-os; ao redimensionar, mova o mapa, não reconstrua.
  • Pule a lente em superfícies com menos de 32px, e em superfícies com will-change ou sua própria camada de composição (menus, painéis animados), onde Chrome pode desenhar o mapa em vez do fundo curvado.
  1. Adapte-se ao que está atrás
  • Para cada superfície, amostre o fundo sob ela em uma grade 5 × 3, descarte os dois pontos mais escuros e os dois mais claros, e faça a média. Luminância é (0.299 R + 0.587 G + 0.114 B) / 255; textura é o ponto mais claro menos o mais escuro.
  • Tinta: em modo claro, texto claro quando a luminância estiver abaixo de 0.5. Mantenha a tinta atual dentro de ±0.05 da linha para que uma superfície nunca pisque ao cruzá-la. Modo escuro é sempre texto claro. Superfícies vizinhas em uma mesma linha compartilham uma decisão.
  • Densidade (0 fina, 1 densa) = 0.55 × quão próximo o fundo está do brilho próprio da tinta + 0.7 × textura + 0.3 × croma. Ela move a tonalidade entre seu alfa fino e denso.
  • Saturação mantida = 1 - 0.75 × croma, pelo menos 0.45, para que um fundo vívido não manche o vidro.
  • Amostre novamente quando o fundo, o tema ou a posição de uma superfície mudar, e lembre-se da última tinta para que o próximo carregamento abra com ela.
  • Se o fundo não for uma imagem que você possa ler (vídeo ao vivo, conteúdo de origem cruzada), escolha a tinta do tema e use a tonalidade densa.
  1. Deixe as pessoas ajustarem a tonalidade
  • Adicione uma configuração para modo claro e uma para modo escuro que escalam a tonalidade, de 0 a 1.5 (1 é o material como projetado). Abaixo de 1, o aumento de brilho no filtro diminui junto, de modo que em 0 resta apenas o desfoque, a borda e a sombra.
  • Cada tema mantém seu próprio valor; alternar temas desliza para o valor daquele tema.
  1. Mantenha acessível
  • Verifique o contraste do texto no fundo mais movimentado e no mais escuro que o produto permite, na tonalidade padrão; aumente a densidade, não a opacidade da tinta, até passar.
  • Respeite prefers-reduced-transparency e forced colors: recorra a uma superfície sólida na mesma tonalidade com opacidade total.
  • Mantenha os anéis de foco, estados desabilitados e cores de erro como estão; falhas mantêm seu vermelho.
  1. Entregue
  • Primeiro, liste as superfícies que você alterará, quais receberão a lente e a divisão de cores, e quais deixará sólidas e por quê.
  • Depois, adicione os tokens, o helper de lente e as duas configurações, troque as superfícies e liste todos os arquivos que você tocou.
  • Não altere layout, fontes, raios ou textos. Se uma superfície precisar de um novo componente para funcionar como vidro, pare e me pergunte primeiro.

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)。

Habilidades Relacionadas