swiftui-ui-patterns

The swiftui-ui-patterns skill provides structured guidance and best practices for building and refactoring SwiftUI user interfaces in iOS applications. It helps developers design maintainable, declarative UI architectures using modern SwiftUI patterns, while avoiding unnecessary complexity in state management and navigation design. The skill focuses on practical implementation workflows for both existing projects and new app scaffolding, helping teams standardize SwiftUI development patterns across screens, navigation flows, sheets, and responsive layouts.

The skill includes recommendations for organizing SwiftUI views into small, composable components, using SwiftUI-native state management tools such as @State, @Binding, @Observable, and @Environment, and selecting ownership patterns based on the lifecycle and scope of data. It also covers architectural patterns for TabView, NavigationStack, sheets, scroll-driven interactions, async state handling with async/await and .task, and environment-based dependency injection. Compatibility guidance is included for projects targeting iOS 16 and earlier, where ObservableObject, @StateObject, and @ObservedObject may still be required. The documentation emphasizes modern API usage while preserving legacy patterns when modifying older codebases.

This skill is intended for iOS developers, SwiftUI engineers, and teams building or maintaining SwiftUI applications. It is especially useful when designing navigation hierarchies, implementing tab-based app structures, composing layouts with VStack and HStack, managing shared application state, or introducing scalable UI conventions into an existing SwiftUI codebase. Developers refactoring UIKit-heavy applications into SwiftUI or standardizing app architecture across multiple features can also benefit from the included patterns and references.