skills.rest
joelhooks
joelhooksCOMMUNITY
Explore all skills by this author →
Website𝕏@joelhooksGitHub

axiom-swiftui-nav

Guide SwiftUI navigation pattern selection for iOS 18+ apps.

61|3|Updated Feb 14, 2026
Search Tags:#state management#navigation#swiftui#ios development#app architecture#deep linking
One-click install
npx skills add https://github.com/joelhooks/joelclaw --skill axiom-swiftui-nav
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: axiom-swiftui-nav
Source: https://github.com/joelhooks/joelclaw/tree/main/.agents/skills/axiom-swiftui-nav
Command: npx skills add https://github.com/joelhooks/joelclaw --skill axiom-swiftui-nav

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill prevents common SwiftUI navigation bugs, ensuring smooth user experiences across different devices and iOS versions by guiding developers on choosing the right navigation patterns and implementing them correctly.

Core Features & Use Cases

  • Navigation Architecture: Guides selection between NavigationStack, NavigationSplitView, and TabView.
  • Deep Linking & State Restoration: Provides patterns for robust deep linking and preserving navigation state.
  • Code Review: Offers a checklist and anti-pattern identification to prevent common navigation errors.
  • Use Case: A developer is unsure whether to use NavigationStack or NavigationSplitView for a new feature. This Skill provides a decision tree and code examples to help them choose the most appropriate pattern, preventing future state corruption or deep link failures.

Quick Start

Use the axiom-swiftui-nav skill to understand how to implement programmatic navigation in SwiftUI using NavigationPath.

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?▼

To choose the right SwiftUI navigation pattern, consider the user interface structure you need. NavigationStack is suited for single-column hierarchical navigation, while NavigationSplitView enables multi-column layouts for iPad and macOS applications.

How do I implement programmatic navigation with NavigationPath in SwiftUI?▼

Implement programmatic navigation in SwiftUI using NavigationPath by binding a path array to your NavigationStack. This allows you to push and pop views programmatically, preventing state corruption and enabling reliable deep linking.

Why do my SwiftUI deep links fail to restore the correct navigation state?▼

SwiftUI deep links fail when navigation state is not properly managed or restored. Using NavigationPath with state restoration patterns ensures the exact view hierarchy is rebuilt accurately, preventing deep link failures and state corruption.

Can I use a coordinator pattern with SwiftUI NavigationStack for app architecture?▼

Yes, you can implement coordinator patterns with SwiftUI NavigationStack. This separates navigation logic from your views, ensuring robust state management and preventing deep link failures across complex iOS app architectures.

What causes navigation state corruption in iOS 18 SwiftUI apps?▼

Navigation state corruption in iOS 18 SwiftUI apps is typically caused by improper state binding or conflicting navigation patterns. Prevent this by using NavigationPath correctly and following established state restoration guidelines.

Related Skills

Explore More Software Engineering Skills→
neogenzneogenz
4

mobile-ios-design

Design iOS interfaces with SwiftUI following Apple's Human Interface Guidelines.

Community
Basic
CharlesWiltgenCharlesWiltgen
1.1k

swiftui-nav

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

Community
Advanced
pproencapproenca
193

ios-navigation

Enforce SwiftUI navigation patterns for iOS 26 modular MVVM-C apps.

Community
Advanced
dpearson2699dpearson2699
981

swiftui-uikit-interop

Wrap UIKit views and controllers in SwiftUI with representable and hosting patterns.

Community
Intermediate