swiftui-macos-navigation

What problem does it solve?

This Skill eliminates the frustration of implementing macOS-appropriate navigation in SwiftUI apps, avoiding common cross-platform mistakes and platform-specific gotchas that lead to broken or non-native user experiences.

Core Features & Use Cases

• Multi-Column Navigation: Build three-column NavigationSplitView layouts with programmatic column visibility control, custom width constraints, and compact mode preferences for document-based macOS apps.
• Window & Deep Link Management: Use openWindow and dismissWindow to manage singleton and multi-instance windows, and implement deep linking to open app content from external sources like browsers, Terminal, or other apps.
• Modal & Drill-Down Navigation: Implement sheets, popovers, alerts, and NavigationStack-based drill-down hierarchies tailored to macOS design patterns, including workarounds for unavailable iOS modifiers like fullscreenCover.
• Use Case: For example, build a note-taking macOS app with a collapsible sidebar for note lists, a tabbed detail view for editing, and support for opening specific notes via deep links from email or messages.

Quick Start

Use the swiftui-macos-navigation skill to implement a toggleable three-column NavigationSplitView with programmatic window opening for document selection in your macOS SwiftUI app.