wellmate-liquid-glass

Governs implementation of a Liquid Glass visual system in a React and TypeScript application.

Updated Jan 1, 2026
One-click install
npx skills add https://github.com/sarkarshivaditya-lab/WellMate --skill wellmate-liquid-glass-sarkarshivaditya-lab
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wellmate-liquid-glass
Source: https://github.com/sarkarshivaditya-lab/WellMate/tree/main/.engineering-skills/wellmate/liquid-glass
Command: npx skills add https://github.com/sarkarshivaditya-lab/WellMate --skill wellmate-liquid-glass-sarkarshivaditya-lab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Applying a translucent glass visual style to a production wellness app risks breaking readability, accessibility, performance, and emergency-state clarity. This Skill provides a normative design-engineering contract that keeps the Liquid Glass rebuild consistent with the existing React + TypeScript + Vite architecture. ## Core Features & Use Cases - Material hierarchy rules: Defines primary, secondary, elevated, subtle, and solid glass surfaces with explicit guidance on which components (BottomNav, AppShell, dialogs, cards, lists) may use each. - Accessibility and performance budgets: Enforces WCAG AA contrast, 44px touch targets, reduced-motion/reduced-transparency fallbacks, and a limit of roughly six blurred containers per mobile viewport. - Component mapping and token integration: Maps existing Radix primitives, layout shells, and domain pages to materials while extending the current token registry instead of creating a parallel system. - Use Case: When rebuilding the WellMate frontend visuals, use this Skill to decide whether a given component should be glass or solid, and to validate the result against accessibility, responsive, and performance checklists. ## Quick Start Use the wellmate-liquid-glass skill to review my planned glass treatment for the BottomNav component and confirm it meets the accessibility and performance requirements.

Frequently Asked Questions about wellmate-liquid-glass

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I apply a liquid glass effect to React components?▼

Build each glass component from five layers: semantic layout, a named material token, optical treatment (fill, backdrop effect, edge, highlight, shadow), interaction state, and a fallback state. Keep effects in named token or class definitions rather than arbitrary inline values.

Which components should use glassmorphism versus solid surfaces?▼

Reserve glass for functional layers like persistent navigation, floating controls, toolbars, and transient sheets or dialogs. Keep content-dense surfaces such as cards, charts, long lists, forms, and sensitive profile data solid or near-opaque for readability.

Does backdrop-filter hurt mobile scrolling performance?▼

Yes, backdrop-filter is a finite rendering budget on mobile. Limit it to roughly six blurred containers per viewport, never apply per-row blur in long lists, avoid nested filters, and prefer transform/opacity animations over animating blur or shadows.

How do I make glassmorphism accessible for reduced transparency?▼

Provide explicit opaque or high-contrast fallbacks independent of the prefers-reduced-transparency media query, since browser support is limited. Verify WCAG AA contrast against the actual composited surface and never reduce text opacity to blend with glass.

When should I avoid using glass effects in a UI?▼

Avoid glass on emergency or destructive controls, dense data content, long scrolling lists, and anywhere contrast cannot be guaranteed over all backgrounds. Emergency UI must use solid high-contrast surfaces with semantic color, labels, and icons.