SwiftUI Navigation Diagnostics

Acerca de

This skill provides a systematic approach to debugging SwiftUI NavigationStack failures, focusing on the 85% of issues caused by state management rather than framework defects. It offers mandatory diagnostic checks, a comprehensive decision tree for identifying root causes like unexpected pops or non-responsive links, and specific patterns for common pitfalls such as lazy container placement or off-thread state modifications. It is particularly useful for developers facing crisis scenarios like production crashes or broken deep link flows in iOS, iPadOS, and other xOS applications.

Características Principales

• Identification of anti-patterns like navigationDestination in lazy containers
• Implementation guidance for MainActor isolation and thread-safe path state
• Comprehensive decision tree for troubleshooting taps, pops, and crashes
• Systematic diagnostic procedures for NavigationStack and NavigationPath
• Standardized logging patterns to monitor navigation state changes
• 61 GitHub stars

Casos de Uso

• Debugging why a NavigationLink fails to push despite state updates
• Fixing immediate pop-back bugs caused by view identity changes
• Resolving deep linking failures occurring during app initialization