Agent-Skills.md

Agent Skills: Navigation Debugger

Debug Leavn navigation issues - NotificationCenter routing, deep links, tab selection, AppCoordinator, modal presentations

UncategorizedID: willsigmon/sigstack/navigation-debugger

Repository

willsigmon/sigstack
willsigmon
91

Install this agent skill to your local

pnpm dlx add-skill https://github.com/willsigmon/sigstack/tree/HEAD/plugins/ios-dev/skills/navigation-debugger

Skill Files

Browse the full folder contents for navigation-debugger.

Download Skill

Loading file tree…

plugins/ios-dev/skills/navigation-debugger/SKILL.md

Skill Metadata

Name
Navigation Debugger
Description
Debug Leavn navigation issues - NotificationCenter routing, deep links, tab selection, AppCoordinator, modal presentations

Navigation Debugger

Fix navigation bugs in Leavn:

  1. Check notification handling:

    • Search for notification name in ContentView
    • Verify .onReceive() handlers exist
    • Check AppCoordinator navigation methods

  2. Common Leavn patterns:

    // Post navigation
NotificationCenter.default.post(
    name: .OpenBibleReference,
    userInfo: ["book": "Genesis", "chapter": 1]
)

// Handle in ContentView
.onReceive(NotificationCenter.default.publisher(for: .OpenBibleReference)) {
    // Navigate to Bible
}

  3. Debug steps:

    • Add AppLog in notification handlers
    • Verify userInfo parsing
    • Check tab selection works
    • Test deep link URLs

Use when: Navigation broken, wrong screen, deep links fail, tab routing issues