/ios-navigation

SwiftUI navigation and deep linking using NavigationStack and Universal Links. Use when implementing NavigationStack or Universal Links deep linking in iOS.

hoangnguyen0403@hoangnguyen0403

GitHub

From plugin

agent-skills-standard

538200 skills1 MCP

Install

$ npx -y skills add hoangnguyen0403/agent-skills-standard --skill ios-navigation --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.
You can call itInvoke it directly when you want it.
Slash command/ios-navigation

Context preview

The summary Claude sees to decide when to auto-load this skill.

SwiftUI navigation and deep linking using NavigationStack and Universal Links. Use when implementing NavigationStack or Universal Links deep linking in iOS.

SKILL.md

ios-navigation.SKILL.md

name: ios-navigation
description: SwiftUI navigation and deep linking using NavigationStack and Universal Links. Use when implementing NavigationStack or Universal Links deep linking in iOS.
metadata:
  triggers:
    files:
    - '**/*View.swift'
    - '**/*App.swift'
    keywords:
    - NavigationStack
    - NavigationLink
    - onOpenURL
    - universalLink
    - NSUserActivity

iOS Navigation (SwiftUI)

Priority: P2 (MEDIUM)

Guidelines

**Stack**: Use `NavigationStack` (iOS 16+) with `NavigationPath` for programmatic control.
**Deep Links**: Handle `onOpenURL` at Root View (`WindowGroup`).
**Universal Links**: Configure Associated Domains (`applinks`) in Entitlements.
**Tabs**: Maintain separate `NavigationStack` instances per `TabItem`.

See [NavigationStack and deep linking examples](references/swiftui-navigation.md)

Anti-Patterns

**No Force Unwrapping**: Use `guard let` when parsing URL components.
**No Broken Back Stack**: Ensure valid path state before appending destinations.
**No Missing Validation**: Check content availability before deep-link navigation.