Communitygithub.com

kubai-liquid-glass

Ajoute un effet de verre liquide aux cartes et panneaux par-dessus des images, fonds d'écran ou vidéos : flou d'arrière-plan avec éclaircissement, réfraction et dispersion chromatique sur les bords, teinte adaptative et couleurs de texte lisibles en modes clair et sombre, sans modification de la mise en page.

Qu'est-ce que kubai-liquid-glass ?

Cette compétence transforme les surfaces d'interface (cartes, lecteurs, barres de recherche, menus, popovers, toasts) en un matériau « verre liquide » qui s'adapte dynamiquement à l'arrière-plan. Elle repose sur des variables CSS (tokens) plutôt que de modifier chaque composant, ce qui permet une application cohérente et facile à maintenir. La compétence implémente un flou d'arrière-plan (backdrop-filter), un effet de lentille optique sur les bords avec dispersion chromatique (rouge décalé de 15 % plus loin, bleu de 15 % moins), et une adaptation automatique de la teinte, de la densité et de la couleur du texte en fonction de la luminance et de la texture de l'arrière-plan. Elle supporte les modes clair et sombre, respecte les préférences d'accessibilité (prefers-reduced-transparency, forced colors), et utilise SVG pour la carte de déplacement de la lentille (uniquement sur Chromium, avec fallback CSS). L'utilisateur peut régler l'intensité de la teinte via deux paramètres (mode clair et mode sombre).

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/kubai087/vibedesign-skills/tree/HEAD/skills/kubai-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

Matériau Verre Liquide

999 petits conseils pour donner plus de qualité à votre produit Vibe – Épisode 010 · @kubai087

Appliquez les modifications suivantes dans le projet de l'utilisateur. Les instructions sont rédigées à la première personne (je, mon, mes) : l'utilisateur parle. Lorsqu'il est mentionné de demander d'abord, arrêtez-vous et interrogez l'utilisateur avant de continuer.

Exigences de modification

Donnez à mes cartes et panneaux un matériau de verre liquide : un verre clair qui prend sa couleur de la scène derrière lui, qui se lit comme une plaque épaisse sur les bords, s'adapte à ce qui se trouve derrière, et garde son texte lisible en mode clair et sombre. Travaillez à l'intérieur de mon système de design existant. Il s'agit d'un changement de surface, pas de mise en page : conservez mon balisage, espacements, rayons, polices, icônes et contenu.

  1. Partez de l'existant
  • Trouvez toutes les surfaces qui se superposent à une image, un fond d'écran, une vidéo ou un arrière-plan chargé : cartes, lecteurs, barres de recherche, barres d'outils, menus, popovers, toasts. Listez-les avec leur composant et leur emplacement.
  • Trouvez comment le produit bascule entre le mode clair et le mode sombre, et où se trouvent ses tokens de couleur. Le verre s'applique à ces tokens, pas à chaque composant.
  • Laissez de côté les surfaces sur un arrière-plan uni ; le verre sur une couleur plate ne fait que griser.
  1. Le matériau sous forme de tokens Construisez-le en un ensemble de variables par état, de sorte qu'une surface s'y abonne en les utilisant. Les nombres sont un point de départ pour une UI de taille normale.
  • Verre clair, texte foncé (par défaut) : teinte blanche à 6–22 % (selon la densité, pas 4) ; backdrop-filter blur(2px) saturate(180%) brightness(1.06), pour que la couleur vienne de derrière et reste vive au lieu de devenir laiteuse. Bordure : 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%. Lumière intérieure, sur une couche à l'intérieur de la surface : un sur-éclairage radial depuis le coin supérieur gauche (white 30% s'estompant à 55%), et de faibles lueurs internes juste à l'intérieur du bord, plus lumineuses en haut et à gauche, une petite ombre en bas.
  • Mode clair sur zone sombre, texte clair : teinte rgb(16 18 22) à 10–30 % ; filter blur(2px) saturate(170%), puis brightness(0.85) ; bordure : une fine ligne blanche interne en haut et un contour foncé de 0.5px.
  • Mode sombre : teinte rgb(20 20 24) à 16–38 % ; filter blur(2px) saturate(160%) brightness(0.8), ce qui assombrit comme un « multiply » avec du noir sans devenir boueux ; la même bordure et la même lumière intérieure à environ un tiers de leur intensité, avec un contour et une ombre plus foncés.
  • Encre, une couleur en paliers fixes, utilisée pour tout ce qui est dessiné sur le verre : sur verre clair black 86% (titres, icônes, heures, progression), rgb(60 60 67) à 70% (secondaire) ; mix-blend-mode multiply ; sur verre foncé white 94%, rgb(235 235 245) à 64% ; mix-blend-mode plus-lighter. Dessinez les icônes dans la couleur opaque et atténuez toute l'icône avec opacity : une couleur translucide s'assombrit là où les traits et les remplissages d'une forme se chevauchent.
  • Une ligne surlignée sur verre clair est une couche plus claire du verre : white 42% au survol, 76% quand elle est sélectionnée, avec un contour blanc. Jamais de lavis gris.
  • Enregistrez les tokens numériques et de couleur avec @property pour qu'une surface glisse entre les états au lieu de sauter.
  1. Appliquez en quatre déclarations Chaque surface ne modifie que celles-ci, et son balisage reste identique :
  • background : la teinte.
  • backdrop-filter : le filtre du matériau, puis la lentille de bord (étape 3) en dernier, pour que les étapes de couleur se fondent en une seule passe et que le pli reste net.
  • box-shadow : la bordure.
  • color : l'encre, avec le mode de fusion sur tout ce qui est dessiné à l'intérieur. Le survol éclaircit la teinte d'environ 14 % au lieu de soulever une ombre.
  1. La lentille de bord
  • Construisez une carte de déplacement pour chaque surface : le rouge est le pli latéral, le vert le pli vertical, 128 correspond à aucun déplacement. Seul un bord se plie ; le milieu reste plat.
  • Le bord mesure environ 44px de large sur une carte (min(44px, le petit côté / 3.5), jamais moins de 4px). Pour une plaque épaisse, un point d à partir du bord regarde vers l'intérieur de 1.1 × rim × (1 - d / rim)^2.6 : dur au bord, là où la scène se replie sur elle-même, s'atténuant jusqu'à rien au bord intérieur du rebord.
  • Dessinez la carte pour le même coin que ce que CSS dessine. Si la surface utilise corner-shape: superellipse(), suivez cette courbe, pas un cercle, sinon le pli et la lumière du bord se manquent aux coins.
  • Placez-la dans un filtre SVG avec feImage (la carte) et feDisplacementMap (scale = 2 × le plus grand décalage), et ajoutez url(#id) à la fin de backdrop-filter.
  • Séparez-la en couleurs : trois passes, rouge 15 % plus loin et bleu 15 % moins, chacune maintenue dans son canal avec feColorMatrix et ajoutée avec des modes de fusion screen. Vérifiez les coins des larges bords sur des arrière-plans chargés ; réduisez la séparation là où elle se transforme en brume.
  • Seul Chromium dessine url() dans backdrop-filter. Vérifiez CSS.supports('backdrop-filter', 'url(#a)') et ignorez Firefox, qui l'analyse et ne dessine rien. Partout ailleurs, le verre CSS seul reste.
  • Attendez que l'image de la carte soit décodée avant de pointer une surface vers le filtre, sinon elle s'affiche sans flou. Donnez à chaque filtre un identifiant unique et son propre . Construisez les cartes une fois par rayon et largeur de bord et réutilisez-les ; lors du redimensionnement, déplacez la carte, ne la reconstruisez pas.
  • Ignorez la lentille sur les surfaces de moins de 32px, et sur les surfaces avec will-change ou leur propre couche de composition (menus, panneaux animés), où Chrome peut dessiner la carte au lieu du fond plié.
  1. Adaptez-vous à ce qui se trouve derrière
  • Pour chaque surface, échantillonnez l'arrière-plan en dessous sur une grille 5 × 3, retirez les deux points les plus sombres et les deux plus clairs, et faites la moyenne. La luminance est (0.299 R + 0.587 G + 0.114 B) / 255 ; la texture est le point le plus clair moins le plus sombre.
  • Encre : en mode clair, texte clair quand la luminance est inférieure à 0.5. Gardez l'encre actuelle à ±0.05 de la ligne pour qu'une surface ne scintille pas au changement. Le mode sombre est toujours en texte clair. Les surfaces voisines d'une même ligne partagent une décision.
  • Densité (0 mince, 1 dense) = 0.55 × à quel point l'arrière-plan est proche de la luminosité propre de l'encre + 0.7 × texture + 0.3 × chroma. Elle déplace la teinte entre son alpha mince et dense.
  • Saturation conservée = 1 - 0.75 × chroma, au moins 0.45, pour qu'un arrière-plan vif ne tache pas le verre.
  • Échantillonnez à nouveau lorsque l'arrière-plan, le thème ou la position d'une surface change, et mémorisez la dernière encre pour que le prochain chargement l'utilise.
  • Si l'arrière-plan n'est pas une image que vous pouvez lire (vidéo en direct, contenu cross-origin), choisissez l'encre du thème et utilisez la teinte dense.
  1. Laissez les gens régler la teinte
  • Ajoutez un réglage pour le mode clair et un pour le mode sombre qui mettent à l'échelle la teinte, de 0 à 1.5 (1 correspond au matériau tel que conçu). En dessous de 1, l'augmentation de luminosité dans le filtre s'amincit avec elle, de sorte qu'à 0 seuls le flou, le bord et l'ombre subsistent.
  • Chaque thème conserve sa propre valeur ; le changement de thème glisse vers la valeur de ce thème.
  1. Gardez-le accessible
  • Vérifiez le contraste du texte sur l'arrière-plan le plus chargé et le plus sombre que le produit autorise, à la teinte par défaut ; augmentez la densité, pas l'opacité de l'encre, jusqu'à ce que ce soit conforme.
  • Respectez prefers-reduced-transparency et forced colors : revenez à une surface pleine dans la même teinte à pleine opacité.
  • Conservez les anneaux de focus, les états désactivés et les couleurs d'erreur tels quels ; les échecs gardent leur rouge.
  1. Livrez
  • Listez d'abord les surfaces que vous allez modifier, celles qui reçoivent la lentille et la séparation des couleurs, et celles que vous laissez pleines et pourquoi.
  • Ajoutez ensuite les tokens, l'assistant de lentille et les deux réglages, basculez les surfaces, et listez chaque fichier que vous avez touché.
  • Ne modifiez pas la mise en page, les polices, les rayons ou le contenu. Si une surface nécessiterait un nouveau composant pour fonctionner en verre, arrêtez-vous et demandez-moi d'abord.

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

Skills associés