skills.rest
fayazara
fayazaraCOMMUNITY
Explore all skills by this author →
𝕏@fayazaraGitHub

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
One-click install
npx skills add https://github.com/fayazara/macos-app-skills --skill macos-settings-ui-fayazara
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
harshav167harshav167

macos-settings-ui

Generate a macOS Settings window scaffold with NavigationSplitView and liquid glass chrome.

Community
Intermediate
AutisticAFAutisticAF
4

generators-settings-kit

Generate SettingsKit or SwiftUI Form settings screens for iOS and macOS apps.

Community
Intermediate
helmordevhelmordev

macos-design-guidelines

Apply macOS Human Interface Guidelines to SwiftUI and AppKit app interfaces.

Community
Advanced
anavvanzinanavvanzin

agency-visionos-spatial-engineer

Design and deploy spatial visionOS interfaces with SwiftUI and RealityKit components.

Community
Advanced