window-management

Configure macOS SwiftUI windows with toolbars, drag regions, materials, and placement rules.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/oliverames/ames-claude --skill window-management-oliverames
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: window-management
Source: https://github.com/oliverames/ames-claude/tree/main/plugins/build-macos-apps-codex/skills/window-management
Command: npx skills add https://github.com/oliverames/ames-claude --skill window-management-oliverames

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Customize macOS SwiftUI windows to fit each window's role by controlling toolbars, titles, backgrounds, drag regions, and placement, ensuring consistent chrome and predictable behavior across the app.

Core Features & Use Cases

  • Toolbar and Title customization to hide or show the title and adjust chrome while preserving accessibility.
  • Drag regions extended into content with WindowDragGesture to keep controls functional.
  • Background and materials via containerBackground to style utility and About panels.
  • Window behavior controls including restoration, minimize, and default launch behavior across different window roles.
  • Window placement policies for default and ideal placement to optimize sizing and positioning on primary and external displays.
  • Borderless and specialized window styles for custom chrome and guided drag affordances.

Quick Start

Configure macOS SwiftUI windows with tailored toolbars, drag regions, materials, and placement rules.

Frequently Asked Questions about window-management

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

FAQPage Schema
How do I customize macOS SwiftUI window toolbars and title visibility?

Customize macOS SwiftUI window toolbars by applying toolbar and toolbarBackgroundVisibility modifiers to hide or show the title and adjust chrome while preserving accessibility across different window roles.

How do I add a drag region to a borderless SwiftUI window on macOS?

Add a drag region to a borderless SwiftUI window by extending drag interactions into the content area with WindowDragGesture, keeping controls functional while allowing the window to be moved.

How do I set default and ideal window placement rules for macOS apps with multiple displays?

Set default and ideal window placement for macOS apps by applying defaultWindowPlacement and windowIdealPlacement modifiers to optimize sizing and positioning across primary and external displays.

Can I apply different window styles for About panels and welcome screens in SwiftUI?

Apply different window styles for About panels and welcome screens in SwiftUI by using windowStyle and containerBackground modifiers to configure borderless windows and custom materials for each specific window role.

What window behavior controls are available for macOS SwiftUI apps?

macOS SwiftUI window behavior controls include windowMinimizeBehavior, restorationBehavior, and defaultLaunchBehavior modifiers to manage how windows restore, minimize, and launch across different roles.

Does this approach to macOS window management work with apps requiring multiple window roles?

This window management approach works with apps requiring multiple window roles by carefully combining toolbar, background, and placement modifiers to ensure consistent chrome and predictable behavior across main navigation, About, and welcome screens.