swiftui-patterns

SKILL.md

SwiftUI 17+ removes ObservableObject boilerplate with @Observable, simplifies environment injection with @Environment, and introduces task-based async patterns. The core principle: use Apple's modern APIs instead of reactive libraries.

| Observable model | @Observable | ObservableObject | | Published property | Regular property | @Published | | Own state | @State | @StateObject | | Passed model (binding) | @Bindable | @ObservedObject | | Environment injection | environment(:) | environmentObject(:) | | Environment access | @Environment(Type.self) | @EnvironmentObject |

| Async on appear | .task { } | .onAppear { Task {} } | | Value change | onChange(of:initial::) | onChange(of:perform:) |

Use when implementing iOS 17+ SwiftUI patterns: @Observable/@Bindable, MVVM architecture, NavigationStack, lazy loading, UIKit interop, accessibility (VoiceOver/Dynamic Type), async operations (.task/.refreshable), or migrating from ObservableObject/@StateObject. Source: johnrogers/claude-swift-engineering.

View raw