name: iOS Navigation description: SwiftUI navigation and deep linking using NavigationStack and Universal Links. metadata: labels: [ios, swiftui, navigation, deep-linking, universal-links] triggers: files: ['/*View.swift', '/*App.swift'] keywords: [ NavigationStack, NavigationLink, onOpenURL, universalLink, NSUserActivity, ]

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