SwiftUI Programming Skill
Installation
SKILL.md
SwiftUI Programming Skill
Build SwiftUI interfaces that are correct for the user's declared platforms and deployment targets. Ask for those targets when an API choice depends on them; never assume the newest SDK is deployable.
Supported baseline
The primary examples use Xcode 15, Swift 5.9, and iOS/iPadOS 17 or macOS 14. SwiftUI itself supports older systems, but newer APIs need explicit availability handling:
| Need | Preferred API | Minimum | Compatibility path |
|---|---|---|---|
| Stack navigation | NavigationStack |
iOS 16, macOS 13, tvOS 16, watchOS 9 | NavigationView remains valid for earlier targets |
| Observation | @Observable |
iOS 17, macOS 14, tvOS 17, watchOS 10 | ObservableObject and @StateObject remain supported |
| Toolbars | .toolbar |
iOS 14, macOS 11, tvOS 14, watchOS 7 | Put controls in the view hierarchy on earlier targets |
| Modern change handling | zero- or two-parameter onChange |
iOS 17, macOS 14, tvOS 17, watchOS 10 | Use the one-parameter overload on earlier targets |
APIs from the OS 27 development cycle are beta material relative to the stable Xcode 26.6 toolchain. Discuss them only when explicitly requested, label them beta, and provide stable fallbacks plus #available gates.