From adopt-liquid-glass
Guide for adopting Apple's Liquid Glass design language in SwiftUI/UIKit/AppKit apps. Covers visual refresh, app icons, controls, navigation, menus, toolbars, windows, modals, layout, search, platform considerations, and custom glass effects. Triggers: 'liquid glass', 'adopt liquid glass', 'glass effect', 'glassEffect', 'Liquid Glass migration', 'Liquid Glass adoption', 'iOS 26 UI update', 'macOS 26 design', 'new Apple design language', '适配 Liquid Glass', '毛玻璃效果'
How this skill is triggered — by the user, by Claude, or both
Slash command
/adopt-liquid-glass:adopt-liquid-glassThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Apple's Liquid Glass design language for SwiftUI, UIKit, and AppKit apps.
Apple's Liquid Glass design language for SwiftUI, UIKit, and AppKit apps.
Match user's language.
glassEffect, GlassEffectContainer, etc.)Determine what the user needs:
| Situation | Action |
|---|---|
| Migrating existing app | Walk through the adoption checklist (Step 2) |
| Building new custom glass UI | Jump to custom glass effects guidance |
| Specific API question | Read reference, give targeted answer with code |
| App icon redesign | Guide through layered icon design |
| Platform-specific question | Give platform-targeted advice |
For migration, work through these areas in order. Read references/liquid-glass-guide.md for detailed guidance on each.
Build & Review — Build with latest Xcode SDK, run on latest platform releases. Standard SwiftUI/UIKit/AppKit components auto-adopt Liquid Glass.
Visual Refresh — Remove custom backgrounds from navigation elements (NavigationStack, NavigationSplitView, titleBar, toolbars). Test with accessibility settings (Reduce Transparency, Reduce Motion).
App Icons — Redesign with layers (foreground/middle/background). Use Icon Composer. Simple, filled, semi-transparent shapes. Test against updated grids.
Controls — Don't hard-code layout metrics. Review color usage (use system colors). Adopt new button styles (.glass, .glassProminent). Use safeAreaBar for scroll edge effects. Use ConcentricRectangle for concentric shapes.
Navigation — Establish clear hierarchy. Consider sidebarAdaptable for tab→sidebar. Use NavigationSplitView for split layouts. Apply backgroundExtensionEffect() for edge-to-edge content.
Menus & Toolbars — Use standard selectors for icon auto-assignment. Group related toolbar items. Use icons over text. Hide entire toolbar items (not inner views).
Windows & Modals — Support arbitrary window sizes. Use split views for fluid resizing. Check sheet corner content. Set action sheet source anchor with confirmationDialog.
Layout — Title-style capitalization for section headers. Adopt grouped form style.
Search — Use Tab(role: .search) for semantic search tabs. Test keyboard layout.
Platform Testing — Test across iOS, iPadOS, macOS, tvOS, watchOS. Use GlassEffectContainer for performance. Profile with Instruments.
When the user needs to apply Liquid Glass to custom views, guide them through:
glassEffect() / glassEffect(in: .rect(cornerRadius:)) / .tint() / .interactive()GlassEffectContainer(spacing:) for multiple effects — controls blending behaviorglassEffectUnion(id:namespace:) for unified shapes across dynamic viewsglassEffectID(_:in:) + @Namespace for transition coordinationmatchedGeometry (within spacing) vs materialize (farther apart)Always read references/liquid-glass-guide.md Section 10 for complete code examples before answering custom glass effect questions.
If the user needs to ship with latest SDKs but keep previous appearance:
UIDesignRequiresCompatibility key to Info.plistGlassEffectContainer, limit onscreen effects, profile regularlyDetailed guide with all code examples and complete API reference:
→ Read references/liquid-glass-guide.md
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub psylch/adopt-liquid-glass-skill --plugin adopt-liquid-glass