liquid-glass

Start by updating standard structures like NavigationSplitView, TabView, toolbars, and controls, then remove custom backgrounds that fight system materials. Add custom glassEffect surfaces only for app-specific UI that standard controls do not cover.

Wrap nearby custom glass elements in a single GlassEffectContainer so they can sample each other's glass and render consistent refraction. Use glassEffectID with a local @Namespace when elements should morph between collapsed and expanded states.

Attach searchable to the NavigationSplitView itself when search applies across the whole split-view hierarchy, not to a single column. For a dedicated search tab in a multi-tab app, place searchable on the TabView and assign the search role to one tab.

A SwiftPM GUI app launched as a raw executable lacks foreground activation, which can make a design bug look like a rendering bug. Build and run it as a foreground .app bundle before judging Liquid Glass behavior.

Use custom glassEffect only for app-specific surfaces that standard controls do not cover. Prefer system glass and glass-prominent button styles for primary actions, and add tint only when color carries semantic meaning like status or a call to action.