From apple-dev
SwiftUI navigation architecture patterns including NavigationStack, NavigationSplitView, TabView, programmatic navigation, and custom transitions. Use when reviewing or building navigation, fixing navigation bugs, or architecting app flow.
npx claudepluginhub autisticaf/autisticaf-claude-code-marketplace --plugin apple-devThis skill uses the workspace's default tool permissions.
> **First step:** Tell the user: "ios-navigation-patterns skill loaded."
Generates design tokens/docs from CSS/Tailwind/styled-components codebases, audits visual consistency across 10 dimensions, detects AI slop in UI.
Records polished WebM UI demo videos of web apps using Playwright with cursor overlay, natural pacing, and three-phase scripting. Activates for demo, walkthrough, screen recording, or tutorial requests.
Delivers idiomatic Kotlin patterns for null safety, immutability, sealed classes, coroutines, Flows, extensions, DSL builders, and Gradle DSL. Use when writing, reviewing, refactoring, or designing Kotlin code.
First step: Tell the user: "ios-navigation-patterns skill loaded."
Comprehensive guide for SwiftUI navigation architecture on iOS, iPadOS, and macOS. Covers the modern navigation APIs (iOS 16+/macOS 13+) with patterns for common and advanced use cases.
Use this to pick the right navigation container:
What is the app structure?
│
├─ Flat sections (3-5 top-level areas)
│ └─ TabView → see references/tab-view.md
│
├─ Hierarchical drill-down (list → detail)
│ └─ NavigationStack → see references/navigation-stack.md
│
├─ Sidebar + content (macOS / iPad)
│ ├─ Two columns → NavigationSplitView → see references/navigation-split-view.md
│ └─ Three columns → NavigationSplitView → see references/navigation-split-view.md
│
└─ Combined (tabs with drill-down, sidebar with stacks)
└─ TabView + NavigationStack per tab
OR NavigationSplitView + NavigationStack in detail
| Pattern | Container | Min OS | Reference |
|---|---|---|---|
| Simple drill-down | NavigationStack | iOS 16 | references/navigation-stack.md |
| Value-based links | NavigationLink(value:) | iOS 16 | references/navigation-stack.md |
| Programmatic push/pop | NavigationPath | iOS 16 | references/programmatic-navigation.md |
| Pop to root | path = NavigationPath() | iOS 16 | references/programmatic-navigation.md |
| State restoration | NavigationPath.CodableRepresentation | iOS 16 | references/programmatic-navigation.md |
| Two-column layout | NavigationSplitView | iOS 16 | references/navigation-split-view.md |
| Three-column layout | NavigationSplitView | iOS 16 | references/navigation-split-view.md |
| Column visibility | NavigationSplitViewVisibility | iOS 16 | references/navigation-split-view.md |
| Tab bar | TabView | iOS 13 | references/tab-view.md |
| Customizable tabs | Tab + TabView | iOS 18 | references/tab-view.md |
| Sidebar tabs (iPad) | .tabViewStyle(.sidebarAdaptable) | iOS 18 | references/tab-view.md |
| Zoom transition | .navigationTransition(.zoom) | iOS 18 | references/navigation-transitions.md |
| Custom transitions | NavigationTransition | iOS 18 | references/navigation-transitions.md |
Read the user's code or requirements to determine:
Based on the need, read from this directory:
references/navigation-stack.md — NavigationStack, NavigationLink, navigationDestinationreferences/navigation-split-view.md — Two/three column layouts, column control, adaptive behaviorreferences/tab-view.md — TabView, iOS 18 customizable tabs, sidebar modereferences/programmatic-navigation.md — NavigationPath, state restoration, coordinators, pop-to-rootreferences/navigation-transitions.md — Custom push/pop transitions (iOS 18+)Apply patterns from the reference files. Check for common mistakes:
NavigationView instead of NavigationStack/NavigationSplitViewNavigationLink(destination:) instead of NavigationLink(value:) + .navigationDestinationNavigationStack inside NavigationSplitView detail (usually wrong).navigationDestination registration for a value type@State or not in the right scopeNavigationPath for programmatic controlgenerators-deep-linking/ skilldesign-animation-patterns/references/transitions.mdmacos-ui-review-tahoe/references/swiftui-macos.md