iOS Navigation (SwiftUI)

Priority: P2 (OPTIONAL)

SwiftUI path-based navigation and deep linking.

Guidelines

• Stack: Use NavigationStack (iOS 16+) with NavigationPath for programmatic control.
• Deep Links: Handle onOpenURL at the Root View (WindowGroup).
• Universal Links: Configure Associated Domains (applinks) in Entitlements.
• Tabs: Maintain separate NavigationStack instances per TabItem.

Navigation Patterns

Anti-Patterns

• No Force Unwrapping: Use guard let when parsing URL components.
• No Broken Back Stack: Ensure valid path state before appending destinations.
• No Missing Validation: Check content availability before deep-link navigation.

Related Topics

ios-design-system | ios-notifications | mobile-ux-core