---

name: ios-navigation description: SwiftUI navigation and deep linking using NavigationStack and Universal Links. Use when implementing NavigationStack or Universal Links deep linking in iOS. metadata: triggers: files: - '/*View.swift' - '/*App.swift' keywords: - NavigationStack - NavigationLink - onOpenURL - universalLink - NSUserActivity

iOS Navigation (SwiftUI)

Priority: P2 (MEDIUM)

Guidelines

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

See NavigationStack and deep linking examples

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.

References

• Navigation Patterns