macos-windows-scenes

Implement macOS 26+ SwiftUI multi-window scenes with WindowGroup, Settings, and DocumentGroup.

1|Updated Jun 5, 2026
One-click install
npx skills add https://github.com/LaughingJackalope/macos-skills --skill macos-windows-scenes
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: macos-windows-scenes
Source: https://github.com/LaughingJackalope/macos-skills/tree/main/macos-windows-scenes
Command: npx skills add https://github.com/LaughingJackalope/macos-skills --skill macos-windows-scenes

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Building macOS multi-window, scene-based SwiftUI apps requires coordinating multiple window types, state restoration, document workflows, and system integrations like menu bar utilities, which is error-prone without comprehensive, macOS-specific guidance.

Core Features & Use Cases

  • Full Scene Type Coverage: Provides implementation patterns for WindowGroup, Window, Settings, MenuBarExtra, and DocumentGroup, the core building blocks of macOS SwiftUI apps.
  • Advanced Window Management: Covers parameterized window opening, window restoration, custom chrome with hidden title bars, and unified toolbar styles for macOS 26+.
  • Use Case: Use this skill to build a document-based text editor with a persistent inspector window, a menu bar utility app, or a multi-window productivity tool with custom window styling, all following Apple's latest best practices.

Quick Start

Use the macos-windows-scenes skill to build a macOS app with multiple window types, a menu bar utility, and document-based editing support following Apple's latest best practices.

Frequently Asked Questions about macos-windows-scenes

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

FAQPage Schema
How do I manage multiple window types in a SwiftUI macOS app?▼

Build menu bar utilities in SwiftUI using the MenuBarExtra scene type to create persistent system utilities that integrate natively with macOS without requiring a standard dock-based window.

What is the best way to build a document-based macOS app with SwiftUI?▼

The best way to build a document-based macOS app with SwiftUI is using the DocumentGroup scene architecture to handle document workflows, file coordination, and automatic window restoration following Apple's latest best practices.

Can I use parameterized window opening in macOS 26 SwiftUI scenes?▼

Yes, you can use parameterized window opening in macOS 26 SwiftUI scenes to pass specific data arguments to WindowGroup instances, allowing dynamic creation of custom-chrome windows with hidden title bars and unified toolbar styles.

How do I implement state restoration and scene lifecycle handling for macOS multi-window apps?▼

Implement state restoration and scene lifecycle handling for macOS multi-window apps by leveraging SwiftUI scene types to manage window persistence, ensuring production-grade window management recovers user sessions accurately.

Does this SwiftUI scene architecture support custom window styles with hidden title bars?▼

Yes, SwiftUI scene architecture supports custom window styles with hidden title bars and unified toolbar styles, allowing you to build custom-chrome macOS applications while maintaining proper macOS system behavior.