iOS UI Router

iOS UI Router

You MUST use this skill for ANY iOS UI work including SwiftUI, UIKit, layout, navigation, animations, and design.

When to Use

Use this router when working with:

• SwiftUI views, state, bindings
• UIKit views and constraints
• Layout issues (Auto Layout, SwiftUI layout)
• Navigation (NavigationStack, deep linking)
• Animations and transitions
• Liquid Glass design (iOS 26+)
• Apple Human Interface Guidelines
• UI architecture and patterns
• Accessibility UI issues

Conflict Resolution

ios-ui vs ios-performance: When UI is slow (e.g., "SwiftUI List slow"):

1. Try ios-ui FIRST — Domain-specific fixes (LazyVStack, view identity, @State optimization) often solve UI performance in 5 minutes
2. Only use ios-performance if domain fixes don't help — Profiling takes longer and may confirm what domain knowledge already knows

Rationale: Jumping to Instruments wastes time when the fix is a known SwiftUI pattern. Profile AFTER trying domain fixes, not before.

Routing Logic

SwiftUI Issues

View not updating → /​skill axiom-swiftui-debugging Navigation issues → /​skill axiom-swiftui-nav Performance/​lag → /​skill axiom-swiftui-performance Layout problems → /​skill axiom-swiftui-layout Stacks/​grids/​outlines → /​skill axiom-swiftui-containers-ref Animation issues → /​skill axiom-swiftui-animation-ref Gesture conflicts → /​skill axiom-swiftui-gestures Architecture/​testability → /​skill axiom-swiftui-architecture App-level composition → /​skill axiom-app-composition iOS 26 features → /​skill axiom-swiftui-26-ref

UIKit Issues

Auto Layout conflicts → /​skill axiom-auto-layout-debugging Animation timing issues → /​skill axiom-uikit-animation-debugging

Design & Guidelines

Liquid Glass adoption → /​skill axiom-liquid-glass Design decisions → /​skill axiom-hig Typography → /​skill axiom-typography-ref TextKit/​rich text → /​skill axiom-textkit-ref

Accessibility

VoiceOver, Dynamic Type → /​skill axiom-accessibility-diag

Testing

UI test flakiness → /​skill axiom-ui-testing

Decision Tree

User asks about UI
  ├─ SwiftUI?
  │  ├─ View not updating? → swiftui-debugging
  │  ├─ Navigation? → swiftui-nav
  │  ├─ Performance? → swiftui-performance
  │  ├─ Layout (adaptive)? → swiftui-layout
  │  ├─ Stacks/​grids/​outlines? → swiftui-containers-ref
  │  │  (VStack, HStack, LazyVGrid, LazyHGrid, OutlineGroup, DisclosureGroup)
  │  ├─ Feature-level architecture? → swiftui-architecture
  │  ├─ App-level composition? → app-composition
  │  │  (root view switching, auth flows, scene lifecycle, modularization)
  │  └─ Animations/​gestures? → swiftui-animation-ref or swiftui-gestures
  │
  ├─ UIKit?
  │  ├─ Auto Layout? → auto-layout-debugging
  │  └─ Animations? → uikit-animation-debugging
  │
  ├─ Design guidelines?
  │  ├─ Liquid Glass? → liquid-glass
  │  ├─ HIG compliance? → hig
  │  └─ Typography? → typography-ref
  │
  └─ Accessibility? → accessibility-diag

Example Invocations

User: "My SwiftUI view isn't updating when I change the model" → Invoke: /​skill axiom-swiftui-debugging

User: "How do I implement Liquid Glass in my toolbar?" → Invoke: /​skill axiom-liquid-glass

User: "NavigationStack is popping unexpectedly" → Invoke: /​skill axiom-swiftui-nav

User: "Should I use MVVM for this SwiftUI app?" → Invoke: /​skill axiom-swiftui-architecture

User: "How do I switch between login and main screens?" → Invoke: /​skill axiom-app-composition

User: "Where should auth state live in my app?" → Invoke: /​skill axiom-app-composition

User: "How do I create a grid layout with LazyVGrid?" → Invoke: /​skill axiom-swiftui-containers-ref

User: "What's the difference between VStack and LazyVStack?" → Invoke: /​skill axiom-swiftui-containers-ref

User: "How do I display hierarchical data with OutlineGroup?" → Invoke: /​skill axiom-swiftui-containers-ref