axiom-swiftui-nav

Guide SwiftUI navigation with NavigationStack, NavigationSplitView, and TabView patterns.

Updated Dec 3, 2025
One-click install
npx skills add https://github.com/tuliopc23/flying-dutchman-app --skill axiom-swiftui-nav-tuliopc23
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: axiom-swiftui-nav
Source: https://github.com/tuliopc23/flying-dutchman-app/tree/main/.claude/skills/axiom-swiftui-nav
Command: npx skills add https://github.com/tuliopc23/flying-dutchman-app --skill axiom-swiftui-nav-tuliopc23

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the complexities of implementing robust navigation in SwiftUI applications, preventing common issues like state corruption, deep link failures, and restoration bugs.

Core Features & Use Cases

  • Architecture Guidance: Helps choose between NavigationStack, NavigationSplitView, and TabView based on app requirements.
  • Programmatic Navigation: Provides patterns for managing NavigationPath, including deep linking and state restoration.
  • Code Review & Best Practices: Offers guidance on avoiding anti-patterns and ensuring correct implementation for iOS 18+ and beyond.

Quick Start

Use axiom-swiftui-nav to get a decision tree for choosing between NavigationStack and NavigationSplitView for your app.

Frequently Asked Questions about axiom-swiftui-nav

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I choose between NavigationStack and NavigationSplitView in SwiftUI?

Choosing between NavigationStack and NavigationSplitView depends on app requirements, with NavigationStack suited for drill-down flows and NavigationSplitView for multi-column layouts. This Skill provides a decision tree to select the correct SwiftUI navigation architecture.

How do I implement deep linking with NavigationPath in SwiftUI?

Implementing deep linking with NavigationPath in SwiftUI requires programmatic navigation management to push destinations based on external triggers. This Skill provides code patterns for managing NavigationPath to support deep linking and state restoration correctly.

Why does my SwiftUI navigation state get corrupted during state restoration?

SwiftUI navigation state corruption during restoration often stems from anti-patterns in managing NavigationPath or TabView hierarchies. This Skill addresses common anti-patterns and offers best practices to prevent navigation state corruption and restoration bugs.

Does this SwiftUI navigation guidance cover iOS 18 features and changes?

Yes, this SwiftUI navigation guidance covers iOS 18+ features and changes. It ensures correct implementation for iOS 18 and beyond, offering best practices to avoid deep link failures and state restoration issues introduced by recent updates.

What is the best way to manage programmatic navigation across TabView and NavigationStack?

The best way to manage programmatic navigation across TabView and NavigationStack involves coordinating NavigationPath state within each tab to maintain independent stacks. This Skill offers architecture guidance and patterns to synchronize navigation state across these SwiftUI components.