IosNavigationStack [pattern] v1.0.0

Use NavigationStack with a NavigationPath binding and .navigationDestination(for:) modifiers for type-safe, programmatically-navigable push/pop hierarchies in iOS 16+.

Label

iOS NavigationStack for Hierarchical Content

Meta

• License: MIT AND Apache-2.0
• License Provenance: legacy-backfill

Problem

NavigationView (deprecated) provides no programmatic navigation API, making deep-linking and state restoration difficult. Custom navigation containers duplicate system behavior without swipe-back gesture support.

Solution

Wrap root content in NavigationStack(path: $navigationPath). Use .navigationDestination(for: ItemType.self) to define push destinations. Control navigation programmatically by appending to or removing from navigationPath. For deep links, populate the path at app launch from the incoming URL or notification.

IosNavigationStack [pattern] v1.0.0

Use NavigationStack with a NavigationPath binding and .navigationDestination(for:) modifiers for type-safe, programmatically-navigable push/pop hierarchies in iOS 16+.

Label

iOS NavigationStack for Hierarchical Content

Meta

• License: MIT AND Apache-2.0
• License Provenance: legacy-backfill

Problem

NavigationView (deprecated) provides no programmatic navigation API, making deep-linking and state restoration difficult. Custom navigation containers duplicate system behavior without swipe-back gesture support.

Solution

Wrap root content in NavigationStack(path: $navigationPath). Use .navigationDestination(for: ItemType.self) to define push destinations. Control navigation programmatically by appending to or removing from navigationPath. For deep links, populate the path at app launch from the incoming URL or notification.

Relations

related: [@community/pattern-ios-large-title-nav, @community/rule-ios-preserve-navigation-state, @community/rule-ios-no-override-swipe-back, @community/constraint-mobile-touch-target-44px, @community/check-touch-target-min, @community/check-mobile-first, @community/check-focus-visible]

Label

iOS NavigationStack for Hierarchical Content

Meta

• License: MIT AND Apache-2.0
• License Provenance: legacy-backfill

Problem

NavigationView (deprecated) provides no programmatic navigation API, making deep-linking and state restoration difficult. Custom navigation containers duplicate system behavior without swipe-back gesture support.

Solution

Wrap root content in NavigationStack(path: $navigationPath). Use .navigationDestination(for: ItemType.self) to define push destinations. Control navigation programmatically by appending to or removing from navigationPath. For deep links, populate the path at app launch from the incoming URL or notification.