SwiftUI Core Patterns

Modern SwiftUI patterns for views, navigation, state, toolbars, and text editing.

Critical Constraints

• ❌ NavigationView → ✅ NavigationSplitView (sidebar/detail) or NavigationStack (push/pop)
• ❌ @StateObject → ✅ @State with @Observable classes (macOS 14+)
• ❌ @ObservedObject → ✅ direct property or @Bindable for bindings
• ❌ @EnvironmentObject → ✅ @Environment with custom key
• ❌ toolbar { } without IDs for customizable toolbars → ✅ toolbar(id:) with ToolbarItem(id:)
• ❌ Old .searchable without behavior → ✅ Add .searchToolbarBehavior(.minimize) for space efficiency
• ❌ Plain String in TextEditor for rich text → ✅ Use AttributedString binding

Reference Index

Navigation Patterns

Sidebar + Detail (macOS preferred)

NavigationSplitView {
    List(selection: $selectedItem) {
        ForEach(items) { item in
            NavigationLink(value: item) { Label(item.name, systemImage: item.icon) }
        }
    }
    .navigationTitle("Items")
} detail: {
    if let selectedItem {
        DetailView(item: selectedItem)
    } else {
        ContentUnavailableView("Select an item", systemImage: "sidebar.left")
    }
}

Push Navigation (iOS preferred)

NavigationStack(path: $path) {
    List(items) { item in
        NavigationLink(value: item) { Text(item.name) }
    }
    .navigationDestination(for: Item.self) { item in
        DetailView(item: item)
    }
}

State Management Quick Reference

Common Mistakes & Fixes

References

• What's new in SwiftUI (WWDC 2025)
• SwiftUI Documentation