swiftui-patterns

SKILL.md

Modern SwiftUI patterns for iOS 26+ with MV architecture, state management, and view composition.

Covers @Observable ownership rules, @State/@Bindable/@Environment wiring, and view decomposition best practices for clean, performant UIs

Includes async data loading with .task, custom ViewModifier styling, environment value patterns, and granular state tracking that only re-renders affected views

Provides iOS 26+ API updates (scroll edge effects, background extensions, @Animatable macro), Writing Tools integration for iOS 18+, and performance guidelines for lazy rendering and stable IDs

Emphasizes MV pattern over view models, with a review checklist and common mistakes section covering @Observable isolation, identity preservation, and proper async handling

SwiftUI Patterns

Modern SwiftUI patterns targeting iOS 26+ with Swift 6.3. Covers architecture, state management, view composition, environment wiring, async loading, design polish, and platform/share integration. Navigation and layout patterns live in dedicated sibling skills. Patterns are backward-compatible to iOS 17 unless noted.

Contents

Architecture: Model-View (MV) Pattern

State Management

View Ordering Convention

View Composition

Environment

Async Data Loading

iOS 26+ New APIs

Performance Guidelines

HIG Alignment

Writing Tools (iOS 18+)

Common Mistakes

Review Checklist

References