axiom-swiftui-nav

Guide SwiftUI navigation architecture selection across NavigationStack, NavigationSplitView, and TabView.

Updated Dec 23, 2025
One-click install
npx skills add https://github.com/pradeepmouli/swift-template --skill axiom-swiftui-nav-pradeepmouli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: axiom-swiftui-nav
Source: https://github.com/pradeepmouli/swift-template/tree/main/.agents/skills/axiom-swiftui-nav
Command: npx skills add https://github.com/pradeepmouli/swift-template --skill axiom-swiftui-nav-pradeepmouli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Facilitates robust navigation architecture decisions in SwiftUI by guiding choices between NavigationStack, NavigationSplitView, and TabView; helps prevent navigation state corruption, deep-link failures, and restoration issues across iOS 18+.

Core Features & Use Cases

  • Guidelines for selecting the right navigation container (Single stack, multi-column, or tab-based) based on target devices and content hierarchy.
  • Patterns for programmatic navigation, deep linking, and state restoration, including representative code snippets and anti-patterns.
  • Coordinators/router reasoning and review prompts to ensure maintainable, testable navigation logic.

Quick Start

Describe your app's navigation scenario to receive a recommended pattern and actionable implementation steps.

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 for SwiftUI navigation?

Choose NavigationStack for single-column hierarchical navigation and NavigationSplitView for multi-column layouts like iPad sidebars. This Skill guides selecting the right container based on target devices and content hierarchy to prevent state corruption.

How do I implement deep linking with programmatic navigation in SwiftUI?

Implement deep linking in SwiftUI by binding navigation paths to state and using programmatic navigation triggers. This Skill provides patterns and code snippets for routing deep links across NavigationStack and TabView without state failures.

Does the coordinator pattern work with SwiftUI NavigationStack?

Yes, the coordinator pattern works with SwiftUI NavigationStack to ensure maintainable, testable navigation logic. This Skill offers router reasoning and review prompts to validate your coordinator implementation across iOS 18+ environments.

What is the best way to handle state restoration in SwiftUI navigation stacks?

State restoration in SwiftUI navigation stacks requires binding persistent path state to your NavigationStack. This Skill outlines patterns for restoring navigation state and highlights anti-patterns that cause restoration issues across iOS 18+.

Why does my SwiftUI per-tab navigation stack lose state when switching tabs?

Per-tab navigation stacks lose state when navigation containers are not structured to maintain independent paths per tab. This Skill provides guidelines for implementing robust TabView navigation architectures with state isolation.