macos-settings-ui

Implements macOS settings windows using NSWindowController and NavigationSplitView with liquid glass chrome for SwiftUI apps.

641|16|Updated May 27, 2026

Search Tags:#navigation #macos #swiftui #settings #liquid-glass #nswindowcontroller

Ready to run

npx skills add https://github.com/fayazara/macos-app-skills --skill macos-settings-ui-fayazara

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: macos-settings-ui
Source: https://github.com/fayazara/macos-app-skills/tree/main/settings-ui
Command: npx skills add https://github.com/fayazara/macos-app-skills --skill macos-settings-ui-fayazara

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill solves the difficulty of implementing modern, native macOS settings windows that adhere to the latest macOS 26 design guidelines, specifically the liquid glass chrome effect which is not natively supported by standard SwiftUI Window scenes.

Core Features & Use Cases

Liquid Glass Chrome: Provides the necessary NSWindowController implementation to achieve the translucent, rounded-corner window style required for macOS 26.
Native Navigation: Implements a robust NavigationSplitView architecture with sidebar, grouped forms, and back/forward toolbar navigation.
Use Case: Use this when building a new preferences window for your app to ensure it feels like a first-party macOS application rather than a ported web or mobile interface.

Quick Start

Use the macos-settings-ui skill to generate a new settings window controller and navigation structure for my current project.

Frequently Asked Questions about macos-settings-ui

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

FAQPage Schema

How do I implement a liquid glass settings window in SwiftUI?▼

To implement a liquid glass settings window, use an NSWindowController with fullSizeContentView styling alongside a SwiftUI NavigationSplitView. This applies the translucent, rounded-corner window style required for native macOS 26 preferences panes.

Why does my SwiftUI settings window not look like a native macOS app?▼

Standard SwiftUI Window scenes lack the native macOS chrome. You need NSWindowController to apply fullSizeContentView window styling and scroll edge effects, ensuring your settings interface feels like a first-party macOS application rather than a ported web view.

How do I add sidebar navigation to my macOS settings panes?▼

Add sidebar navigation to macOS settings panes by implementing NavigationSplitView architecture. This provides a robust sidebar with grouped forms and back/forward toolbar navigation, matching the professional preferences layout of first-party macOS applications.

Can I use standard SwiftUI Window scenes for macOS 26 liquid glass aesthetics?▼

Standard SwiftUI Window scenes do not natively support macOS 26 liquid glass aesthetics. You must use NSWindowController to achieve the required translucent window style and proper activation policy management for professional settings panes.

What is the best way to build native macOS preferences panes with grouped forms?▼

The best way to build native macOS preferences panes is combining NSWindowController and NavigationSplitView. This approach delivers grouped forms, sidebar navigation, and liquid glass chrome, satisfying modern macOS 26 design guidelines for professional applications.

How do I manage activation policy for a macOS settings window?▼

Manage activation policy for a macOS settings window by implementing it through NSWindowController. Proper activation policy management ensures your preferences window behaves correctly with scroll edge effects and fullSizeContentView styling in SwiftUI-based macOS applications.