Axiom Swiftui Nav

What it does

The Axiom Swiftui Nav skill streamlines iOS app development by generating SwiftUI navigation stacks and views based on provided data axioms. It assists developers in making informed decisions about navigation architecture, implementing programmatic navigation with NavigationPath, and addressing common challenges like deep linking and state restoration. This skill helps ensure robust and maintainable navigation within SwiftUI applications.

When to use it

• Choosing between different navigation architectures (e.g., NavigationStack vs. NavigationSplitView vs. TabView).
• Implementing programmatic navigation using NavigationPath.
• Setting up deep linking and URL routing functionality.
• Restoring navigation state after the app goes to background.
• Adopting Tab/Sidebar patterns (available in iOS 18+).
• Implementing coordinator or router patterns for navigation management.

Key capabilities

• Provides a decision tree to help select appropriate navigation architecture based on device targets, content hierarchy depth, and multiplatform requirements.
• Demonstrates NavigationPath manipulation patterns for actions like pushing, popping, and deep linking.
• Offers guidance on URL parsing, path construction order, and timing issues related to deep links.
• Provides examples of state restoration techniques using Codable NavigationPath and SceneStorage.
• Includes Router pattern examples and advice on when coordinators are beneficial versus adding unnecessary complexity.

Example prompts

• "Should I use NavigationStack or NavigationSplitView for my app?"
• "How do I navigate programmatically in SwiftUI?"
• "My deep links aren't working; the app opens but shows the wrong screen."

Tips & gotchas

• Avoid using deprecated NavigationView on iOS 16 and later, as it has different behavior. The skill provides patterns to replace this with modern alternatives.
• Consider using the related axiom-swiftui-nav-diag skill for troubleshooting navigation failures.
• For a comprehensive API reference (including Tab customization and iOS 26+ features), utilize the axiom-swiftui-nav-ref skill.