Liquid Glass — Apple's New Material Design System

Implement Apple's Liquid Glass material with SwiftUI glassEffect and scrollEdgeEffect modifiers.

1|Updated Dec 22, 2025
One-click install
npx skills add https://github.com/lqSky7/traverse-ios --skill liquid-glass-apple-s-new-material-design-system
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Liquid Glass — Apple's New Material Design System
Source: https://github.com/lqSky7/traverse-ios/tree/main/traverse
Command: npx skills add https://github.com/lqSky7/traverse-ios --skill liquid-glass-apple-s-new-material-design-system

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Liquid Glass provides a unified, adaptive UI material that uses lensing-based visuals to improve legibility and visual hierarchy across Apple platforms (iOS, iPadOS, macOS, visionOS) while handling light/dark contexts, motion, and platform adaptation.

Core Features & Use Cases

  • Lensing-based material that adapts to background content and environment
  • Variants Regular and Clear with usage guidelines and three-condition rule for Clear
  • Adaptive tinting, scroll edge effects, accessibility features, and performance considerations
  • Platform-wide adoption and design consistency across navigation, controls, and UI surfaces
  • Real-world use: applying Liquid Glass to navigation bars, menus, and interactive elements to improve clarity and polish

Quick Start

Wrap a view with the .glassEffect() modifier to apply Liquid Glass using the default capsule shape.

Frequently Asked Questions about Liquid Glass — Apple's New Material Design System

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

FAQPage Schema
How do I apply Liquid Glass effects to navigation bars in SwiftUI?

To apply Liquid Glass in SwiftUI, wrap your view with the .glassEffect() modifier. This lensing-based material automatically adapts to background content, improving legibility and visual hierarchy across iOS, iPadOS, macOS, and visionOS.

What is the difference between Regular and Clear Liquid Glass variants?

Regular and Clear are Liquid Glass variants with specific usage guidelines. The system uses a three-condition rule to determine when the Clear variant is appropriate, ensuring adaptive UI maintains proper contrast and accessibility across different contexts.

Does Liquid Glass support accessibility and dark mode adaptation?

Yes, Liquid Glass includes built-in accessibility guarantees and automatic light/dark context adaptation. The material handles environmental changes automatically, ensuring your adaptive UI remains legible and performs well across Apple platforms.

How do I add tinting and scroll edge effects to glassEffect views?

You can add adaptive tinting and scroll edge effects to glassEffect views using SwiftUI modifiers like scrollEdgeEffect. These tools help maintain visual clarity and hierarchy as users scroll through content layered behind Liquid Glass surfaces.

Can I use Liquid Glass material across all Apple platforms?

Yes, Liquid Glass provides a unified design system for platform-wide adoption across iOS, iPadOS, macOS, and visionOS. It includes automatic platform adaptations to ensure design consistency for navigation bars, controls, and interactive elements.

What are the performance considerations when implementing Liquid Glass?

Liquid Glass addresses performance considerations by providing a unified design system with built-in accessibility guarantees. It uses new SwiftUI container APIs and modifiers to efficiently render lensing-based visuals without compromising app responsiveness.