liquid-glass

Apply system Liquid Glass materials to SwiftUI interfaces in macOS apps.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/oliverames/ames-claude --skill liquid-glass-oliverames
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: liquid-glass
Source: https://github.com/oliverames/ames-claude/tree/main/plugins/build-macos-apps-codex/skills/liquid-glass
Command: npx skills add https://github.com/oliverames/ames-claude --skill liquid-glass-oliverames

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill consolidates macOS SwiftUI modernization by replacing bespoke chrome with system-backed glass surfaces to improve consistency, accessibility, and visual coherence across toolbars, sidebars, and sheets.

Core Features & Use Cases

  • Prefers system Liquid Glass materials for NavigationSplitView sidebars, toolbars, and sheets to achieve native look and feel.
  • Guides where to apply custom glass only when necessary, and how to avoid overdraw that can hinder automatic scroll-edge effects.
  • Uses GlassEffectContainer and glassEffectID to morph visuals between collapsed and expanded states, enabling smooth transitions across app sections.

Quick Start

Apply Liquid Glass to convert standard macOS UI chrome to system glass surfaces, starting with the NavigationSplitView and toolbar areas.

Frequently Asked Questions about liquid-glass

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

FAQPage Schema
How do I apply Liquid Glass to SwiftUI toolbars and NavigationSplitView in macOS 26?

To apply Liquid Glass to SwiftUI toolbars and sidebars in macOS 26, replace custom chrome with system-backed glass materials. This modernizes NavigationSplitView surfaces by enforcing native visual coherence across your application interface.

What is the best way to morph glass visuals between collapsed and expanded states in SwiftUI?

The best way to morph SwiftUI glass visuals between states is using GlassEffectContainer and glassEffectID. These APIs enable smooth transitions across app sections while preserving accessibility during visual state changes.

When should I use custom glass materials instead of system Liquid Glass surfaces?

You should only use custom glass materials when system Liquid Glass surfaces cannot achieve the required visual result. Overusing custom glass can hinder automatic scroll-edge effects and break the native macOS design coherence.

Does replacing bespoke chrome with system glass affect accessibility in macOS apps?

Replacing bespoke chrome with system glass improves accessibility by enforcing native macOS design guidelines. Utilizing system-backed glass surfaces ensures consistent visual coherence and maintains standard accessibility behaviors across toolbars and sheets.

Why does overdraw hinder automatic scroll-edge effects in SwiftUI glass interfaces?

Overdraw hinders automatic scroll-edge effects because overlapping custom glass layers interfere with the system's native material rendering. Preferring system Liquid Glass materials allows SwiftUI to properly manage toolbar and sidebar translucency.