Skip to content

macOS ​

Build native macOS apps the supported way: SwiftUI-first, multi-window, keyboard-driven, sandboxed, and ready for Mac App Store or Developer ID distribution. These skills cover scene types, menu bar commands, AppKit interop and modernization, touch input, App Sandbox file access, Settings panes, notarized direct distribution, bringing iOS apps to the Mac, and screen capture.

When to Use These Skills ​

Use macOS skills when you're:

  • Building a new macOS app or adding a Mac target to an iOS-first codebase
  • Picking between WindowGroup, Window, UtilityWindow, MenuBarExtra, and Settings
  • Wiring menu bar commands to the focused window via focusedSceneValue
  • Bringing SwiftUI patterns from iOS to macOS: Table, NavigationSplitView, inspectors, focus, and toolbars
  • Adopting App Sandbox, security-scoped bookmarks, and file-access entitlements
  • Adding a Settings (Preferences) window with tabbed panes and @AppStorage
  • Distributing outside the Mac App Store via Developer ID, notarytool, and Sparkle
  • Embedding AppKit views in SwiftUI (or vice versa) with NSViewRepresentable and NSHostingController
  • Modernizing an existing AppKit app's input handling, state restoration, and macOS 27 look
  • Bringing an iPhone or iPad app to the Mac with Mac Catalyst or as a Designed for iPad app
  • Recording, sharing, or capturing the screen with ScreenCaptureKit
  • Making your app work with touch on a touch-display Mac or a Sidecar iPad

Example Prompts ​

Questions you can ask your assistant that will draw from these skills:

  • "How do I structure a macOS app that has a main window plus an activity panel?"
  • "My menu bar commands are always disabled — what's wrong?"
  • "Should this be a List or a Table?"
  • "My app works in debug but fails to open files in release. Why?"
  • "How do I notarize and staple my app for Developer ID distribution?"
  • "Where should the Settings window's .frame() go — on the TabView or each tab?"
  • "I need to embed an NSTextView inside SwiftUI. What's the lifecycle?"

Skills ​

  • Windows – Scene types, openWindow, default size, MenuBarExtra, UtilityWindow

    • "WindowGroup vs Window vs UtilityWindow — which do I use?"
    • "How do I open a detail window from a context menu without adding a File menu item?"
  • Menus and Commands – Menu bar architecture, CommandMenu/CommandGroup, focusedSceneValue, context menus

    • "Why is my menu item always disabled even though the window is focused?"
    • "How do I add 'New Plant' before the standard 'New' group in the File menu?"
  • SwiftUI Differences – Table vs. List, NavigationSplitView, inspectors, focus, toolbars, multi-window state

    • "My iPad-style sheet feels wrong on Mac. What's the macOS equivalent?"
    • "My table headers show sort indicators but the rows don't reorder. What did I miss?"
  • Sandbox and File Access – The App Sandbox model, fileImporter, security-scoped bookmarks, entitlements

    • "My app loses file access after a few open/close cycles. What's leaking?"
    • "How do I keep access to a user-selected folder across app launches?"
  • Settings – Settings scene, tabbed panes, sizing, SettingsLink, @AppStorage

    • "Where does the .frame() go on a tabbed Settings window?"
    • "How do I share one codebase across iOS and macOS where macOS needs a Settings scene?"
  • Direct Distribution – Developer ID code signing, notarytool, stapling, packaging, Sparkle auto-updates

    • "My notarization keeps failing with 'signature does not include a secure timestamp.' How do I fix it?"
    • "What's the right order to sign an app with embedded frameworks and XPC services?"
  • AppKit Interop – NSViewRepresentable, NSHostingController/NSHostingView, the responder chain, NSToolbar bridging

    • "How do I host an NSTextView inside SwiftUI and keep bindings synced?"
    • "My SwiftUI cells inside NSCollectionView cause scroll jank. What's the right reuse pattern?"
  • iOS Apps on Mac – Designed for iPad vs. Mac Catalyst, opting out of Mac App Store availability, a Catalyst adoption checklist, runtime-detection traps

    • "Should I ship my iPad app as Designed for iPad or build with Mac Catalyst?"
    • "Why does my iOS app on Apple Silicon report isMacCatalystApp as true?"
  • AppKit Modernization – Control events, state restoration, status-item sessions, concentric corners

    • "What replaces my mouseDown override in a modern AppKit app?"
    • "How do I restore window state after relaunch on macOS 27?"
  • ScreenCaptureKit – Screen recording, sharing pickers, SCStream capture, screenshots

    • "How do I record a single window to a file with ScreenCaptureKit?"
    • "How do I let users pick what to share with SCContentSharingPicker?"
  • Touch – Touch on touch-display Macs and Sidecar: design rules, gesture recognizers instead of tracking loops, hit targets, hover, exclusive views

    • "Is my AppKit app ready for the touchscreen MacBook Pro?"
    • "How do I add touch to a view that uses a tracking loop?"
  • axiom-swiftui – Cross-platform SwiftUI patterns (state, layout, animations, navigation fundamentals) that the macOS-specific patterns build on
  • axiom-security – Keychain, encryption, passkeys, and certificate management; pair with sandbox-and-file-access and direct-distribution
  • axiom-shipping – App Store submission, rejections, privacy manifests; complements direct-distribution for App Store-bound macOS apps
  • axiom-uikit – UIKit-SwiftUI bridging; the same Representable pattern as AppKit interop, but with UIView/UIViewController
  • axiom-payments – Apple Pay on the Mac and in Catalyst apps

Released under the MIT License