Does this skill work for all xOS platforms?

Yes, it is designed for modern xOS development, including iOS, iPadOS, watchOS, and tvOS apps using the latest SwiftUI navigation patterns.

How can I debug deep links that aren't showing the right screen?

Deep link failures are typically timing or threading issues. This skill includes patterns to verify URL reception and ensure path modifications occur on the MainActor.

Why does my view pop back to the root immediately after pushing?

This is often caused by the NavigationPath state being recreated during a view render or a change in view identity. The skill helps identify where your @State is incorrectly localized.

Why is my SwiftUI NavigationLink not responding when tapped?

This usually occurs if the NavigationLink is placed outside the NavigationStack hierarchy or if the navigationDestination is inside a lazy container. This skill provides specific checks to verify view hierarchy and destination scope.

SwiftUI Navigation Diagnostics

Name: SwiftUI Navigation Diagnostics
Author: CharlesWiltgen

byCharlesWiltgen

•

233

Mobile Development

Diagnoses and resolves complex SwiftUI navigation issues, including path state management, view identity errors, and deep linking failures.

About

The axiom-swiftui-nav-diag skill is a specialized diagnostic tool designed to troubleshoot and fix common SwiftUI navigation failures. It provides a systematic framework for debugging NavigationStack and NavigationPath issues, helping developers resolve non-responsive links, unexpected pops, and state loss without resorting to complex UIKit wrappers. By following production-tested diagnostic patterns and a detailed decision tree, this skill identifies root causes such as misplaced navigation destinations, threading issues, and view identity changes in minutes.

Key Features

Systematic path state management and logging patterns
Deep link and state restoration debugging protocols
Identification of view identity and placement errors
233 GitHub stars
MainActor and threading verification for navigation updates
Comprehensive decision tree for rapid navigation troubleshooting

Use Cases

Resolving navigation state loss when switching between tabs or backgrounding an app
Fixing 'ghost' pops where a view immediately returns to the root after being pushed
Debugging deep links that fail to navigate to the correct screen on app launch

About

Key Features

Systematic path state management and logging patterns
Deep link and state restoration debugging protocols
Identification of view identity and placement errors
233 GitHub stars
MainActor and threading verification for navigation updates
Comprehensive decision tree for rapid navigation troubleshooting

Use Cases

Resolving navigation state loss when switching between tabs or backgrounding an app
Fixing 'ghost' pops where a view immediately returns to the root after being pushed
Debugging deep links that fail to navigate to the correct screen on app launch