Skip to content
cccskills
FreePublished on GitHub

liquid-glass

Build Apple-inspired translucent interfaces using shared CSS settings and component patterns. The skill covers glass cards, toolbars, buttons, and modals, with light and dark modes, motion guidance, and accessibility requirements for readable text and reduced animation.

OriginalShow the original description

Apple Liquid Glass design system. Use when building UI with translucent, depth-aware glass morphism following Apple's design language. Provides CSS tokens, component patterns, dark/light mode, and animation specs.

See how to install

Good for

  • Designing translucent cards and buttons
  • Styling glass toolbars and modals
  • Supporting light and dark interface modes
  • Adjusting contrast and motion for accessibility

Files included (2)

  • SKILL.md3.7 KB
  • references/tokens.css2.1 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Liquid Glass Design System

Apple-inspired translucent glass UI with depth, refraction, and ambient light response.

Core Principles

  1. Translucency — Surfaces reveal layered content beneath via backdrop blur
  2. Depth — Elements float on distinct z-layers with realistic shadows
  3. Ambient Response — Glass tints shift based on underlying content color
  4. Minimal Chrome — Borders are subtle; shape and blur define boundaries
  5. Motion — Transitions feel physical: spring-based, with inertia

Usage

Import the token file in your CSS:

@import 'references/tokens.css';

CSS Tokens Reference

All tokens are defined in references/tokens.css. Key categories:

CategoryPrefixExample
Glass backgrounds--lg-bg-*--lg-bg-primary
Blur--lg-blur-*--lg-blur-md
Borders--lg-border-*--lg-border-color
Shadows--lg-shadow-*--lg-shadow-elevated
Radius--lg-radius-*--lg-radius-lg
Animation--lg-duration-*--lg-duration-normal

Component Patterns

Glass Card

.glass-card {
  background: var(--lg-bg-primary);
  backdrop-filter: blur(var(--lg-blur-md));
  -webkit-backdrop-filter: blur(var(--lg-blur-md));
  border: 1px solid var(--lg-border-color);
  border-radius: var(--lg-radius-lg);
  box-shadow: var(--lg-shadow-elevated);
  transition: transform var(--lg-duration-normal) var(--lg-easing-spring);
}

.glass-card:hover {
  transform: translateY(-2px);
  box-shadow: var(--lg-shadow-high);
}

Glass Toolbar

.glass-toolbar {
  background: var(--lg-bg-toolbar);
  backdrop-filter: blur(var(--lg-blur-lg)) saturate(var(--lg-saturate));
  -webkit-backdrop-filter: blur(var(--lg-blur-lg)) saturate(var(--lg-saturate));
  border-bottom: 1px solid var(--lg-border-subtle);
}

Glass Button

.glass-btn {
  background: var(--lg-bg-interactive);
  backdrop-filter: blur(var(--lg-blur-sm));
  border: 1px solid var(--lg-border-color);
  border-radius: var(--lg-radius-md);
  transition: all var(--lg-duration-fast) var(--lg-easing-spring);
}

.glass-btn:active {
  transform: scale(0.97);
  background: var(--lg-bg-pressed);
}

Glass Modal Overlay

.glass-overlay {
  background: var(--lg-bg-scrim);
  backdrop-filter: blur(var(--lg-blur-xl));
}

.glass-modal {
  background: var(--lg-bg-elevated);
  border: 1px solid var(--lg-border-color);
  border-radius: var(--lg-radius-xl);
  box-shadow: var(--lg-shadow-high);
}

Dark / Light Mode

Tokens auto-switch via prefers-color-scheme. Light mode uses white-tinted glass; dark mode uses dark-tinted glass with higher blur to maintain readability.

/* Force a mode on a subtree */
.light-glass { color-scheme: light; }
.dark-glass  { color-scheme: dark; }

Animations

Use spring-based easing for physical feel:

/* Entry */
@keyframes glass-enter {
  from { opacity: 0; transform: scale(0.95) translateY(8px); }
  to   { opacity: 1; transform: scale(1) translateY(0); }
}

.glass-animate-in {
  animation: glass-enter var(--lg-duration-normal) var(--lg-easing-spring) both;
}

Accessibility

  • Ensure contrast-ratio ≥ 4.5:1 for text over glass surfaces
  • Respect prefers-reduced-motion — disable blur animations, use opacity-only transitions
  • Provide prefers-contrast: high overrides that replace translucent backgrounds with solid ones

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

adapt

FreeSummary

Adapts existing designs for phones, tablets, desktops, print, and email. Adjusts layouts, navigation, content priorities, and touch controls to suit each context, with guidance for responsive sizing and verification across devices and input methods.

  • Adapting a desktop interface for mobile use
  • Adjusting tablet layouts for portrait and landscape
  • Expanding a mobile design for desktop screens
fengshao1227/ccg-workflow5.9KUpdated Oct 21, 2026

Audit a website for Google AdSense application readiness or ongoing ad-serving issues. Check content, navigation, crawler access, and disclosures against official requirements, then receive evidence-based findings, specific fixes, and a complete checklist with unresolved questions clearly marked.

  • Checking a site before applying for AdSense
  • Investigating issues after an AdSense rejection
  • Reviewing policy risks on a site that already serves ads
fengshao1227/ccg-workflow5.9KUpdated Oct 21, 2026

ai

FreeSummary

Routes AI development questions to focused references on agents, language model security, retrieval-augmented generation, which uses retrieved information in answers, and prompt design and evaluation. It also outlines principles for validation, safety boundaries, version control, and ongoing assessment.

  • Find guidance for agent development
  • Locate references on prompt injection defenses
  • Explore retrieval and reranking for RAG
fengshao1227/ccg-workflow5.9KUpdated Oct 21, 2026

animate

FreeSummary

Review an interface and add purposeful motion to buttons, forms, navigation, and state changes. Plan and implement animations that clarify actions and provide feedback, while checking performance and supporting users who prefer reduced motion.

  • Adding visual feedback to buttons and forms
  • Smoothing menu, modal, and tab transitions
  • Planning page entrances and scroll reveals
fengshao1227/ccg-workflow5.9KUpdated Oct 21, 2026

architecture

FreeSummary

Find the relevant architectural guidance for API design, security, cloud infrastructure, message queues, and caching. This skill acts as an index to specialized references and lists principles for structuring software, distributed systems, and access controls.

  • Finding guidance for API design
  • Reviewing security architecture topics
  • Exploring containers, K8s, and Serverless
fengshao1227/ccg-workflow5.9KUpdated Oct 21, 2026

arrange

FreeSummary

Improve interface layouts by reviewing spacing, alignment, content density, and visual hierarchy, the cues that show what matters most. Refine repetitive card grids and crowded sections into compositions with consistent spacing and responsive structure.

  • Adjusting spacing in a crowded interface
  • Making important content easier to spot
  • Varying repetitive card-based layouts
fengshao1227/ccg-workflow5.9KUpdated Oct 21, 2026

See all skills by fengshao1227

Report a problem with this skill