macos-app-design

Guides design and implementation of native macOS applications with SwiftUI and AppKit.

Updated May 11, 2026
One-click install
npx skills add https://github.com/cloudofgeorge/AI-hands-Engineer --skill macos-app-design-cloudofgeorge
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: macos-app-design
Source: https://github.com/cloudofgeorge/AI-hands-Engineer/tree/main/skills/engineering/domains/macos/macos-app-design
Command: npx skills add https://github.com/cloudofgeorge/AI-hands-Engineer --skill macos-app-design-cloudofgeorge

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building a macOS app that feels native requires mastering many platform conventions—menu bar structure, keyboard shortcuts, window behavior, Liquid Glass materials, and accessibility—and missing any of them makes an app feel foreign on the Mac. ## Core Features & Use Cases - Mac Citizen Checklist: Covers menu bar layout, keyboard shortcuts, multi-window behavior, sidebars, toolbars, text handling, and accessibility requirements. - Liquid Glass Guidance: Defines where to apply the macOS Tahoe design material and where to avoid it, plus Icon Composer and SF Symbols workflows. - Evaluation Rubrics: Provides an Apple Design Awards-inspired rubric and a Definition of Done checklist for release gating. - Use Case: When building a SwiftUI document-based app, use this Skill to define the app archetype, command map, and accessibility plan before writing code, then validate the result against the checklist. ## Quick Start Use the macos-app-design skill to review my SwiftUI app's menu bar, toolbar, and sidebar structure for native macOS conventions.

Frequently Asked Questions about macos-app-design

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

FAQPage Schema
How do I make my SwiftUI app feel native on macOS?▼

Use standard menu bar layout (App/File/Edit/View/Window/Help), support ⌘, for Settings, keep standard shortcuts working, and prefer system components over custom UI. The Skill provides a full Mac Citizen checklist covering windows, sidebars, toolbars, and text behavior.

When should I use SwiftUI vs AppKit for a Mac app?▼

Prefer SwiftUI for new apps due to faster iteration and modern patterns. Drop to AppKit for advanced text editing, deep window customization, or pro-workflow integrations, keeping the bridging layer thin and well-tested.

What is Liquid Glass in macOS Tahoe and where should I use it?▼

Liquid Glass is Apple's translucent design material introduced in macOS Tahoe 26. Apply it only to the navigation and controls layer such as toolbars and sidebars, never to content like tables or lists, and avoid stacking glass on glass.

How do I create a modern macOS app icon with Icon Composer?▼

Design layered artwork on a 1024px canvas, add dynamic glass properties in Icon Composer rather than baking them in, and export vectors as SVG. Icon Composer requires macOS Sequoia 15.3+ and supports up to four layer groups across default, dark, clear, and tinted appearances.

What accessibility features must a macOS app support?▼

Every interactive element needs VoiceOver labels, all functions must work keyboard-only, and the UI must remain usable with Reduced Motion, Reduced Transparency, and Increased Contrast enabled. Liquid Glass adapts automatically, but custom animations must respect these settings too.