macos-app-design

Guide SwiftUI and AppKit macOS app design with system integration planning.

5|2|Updated Jan 20, 2026

Search Tags:#accessibility #macos #swiftui #design-system #liquid-glass #app-design #macos-ui

Ready to run

npx skills add https://github.com/petekp/agent-skills --skill macos-app-design

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: macos-app-design
Source: https://github.com/petekp/agent-skills/tree/main/skills/macos-app-design
Command: npx skills add https://github.com/petekp/agent-skills --skill macos-app-design

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill provides a comprehensive blueprint for building macOS-native apps that feel aligned with Apple conventions, ensuring fast, accessible, and native-feeling experiences.

Core Features & Use Cases

Guidance on macOS citizen design principles, including menu bars, keyboard shortcuts, multi-window behavior, and Liquid Glass usage for navigation chrome.
Reference architecture and design patterns for SwiftUI and AppKit, with deliverables like IA, state modeling, and accessibility plans.
Practical workflows for teams to plan, design, and validate macOS experiences that integrate with macOS workflows.

Quick Start

Access the macOS design guide and initial archetype planning to start a world-class macOS app project.

Frequently Asked Questions about macos-app-design

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

FAQPage Schema

How do I design a native macOS app interface using SwiftUI?▼

To design a native macOS app interface using SwiftUI, you need to follow macOS citizen principles and Liquid Glass rules for navigation chrome. This ensures your app's windows, sidebars, and toolbars align with Apple conventions for a first-class experience.

What makes an app feel like first-class macOS software?▼

First-class macOS software integrates deeply with system conventions like menu bars, keyboard shortcuts, and multi-window behavior. Adhering to macOS citizen design principles ensures your SwiftUI or AppKit interface feels fast, accessible, and native.

How do I plan the architecture and accessibility for a macOS application?▼

You plan macOS application architecture and accessibility by using a structured deliverables checklist that includes information architecture, state modeling, and accessibility planning. This validates that your SwiftUI or AppKit interfaces meet native standards.

Can I use AppKit alongside SwiftUI for macOS app design?▼

Yes, you can use AppKit alongside SwiftUI for macOS app design. The skill provides reference architecture and design patterns for both frameworks to help you build navigation structures and system integrations that feel native.

What is the best way to implement Liquid Glass in macOS navigation chrome?▼

Implementing Liquid Glass in macOS navigation chrome requires adhering to specific Liquid Glass rules for your interface. This guides the design of translucent navigation structures like toolbars and sidebars within your native macOS app.

Does native macOS app design require specific menu bar and keyboard shortcut planning?▼

Yes, native macOS app design requires specific menu bar and keyboard shortcut planning. Following macOS citizen principles ensures your app integrates properly with system workflows and provides accessible, conventional navigation.