SwiftUI

You MUST use this skill for ANY SwiftUI work including views, state, navigation, layout, animations, architecture, gestures, and debugging.

Quick Reference

skills/debugging.md

skills/debugging-diag.md

skills/nav.md

skills/nav-diag.md

skills/nav-ref.md

skills/layout.md

skills/layout-ref.md

skills/swiftui-performance.md

skills/architecture.md

skills/animation-ref.md

skills/containers-ref.md

skills/containers-ref.md

skills/search-ref.md

skills/gestures.md

skills/26-ref.md

Non-SwiftUI UI Routes

These topics are part of the broader iOS UI domain but live in separate suites:

UIKit issues

• Auto Layout conflicts → See axiom-uikit (skills/auto-layout-debugging.md)
• Animation timing → See axiom-uikit (skills/uikit-animation-debugging.md)
• SwiftUI ↔ UIKit bridging → See axiom-uikit (skills/uikit-bridging.md)

Design & guidelines

• Liquid Glass adoption → See axiom-design (skills/liquid-glass.md)
• SF Symbols → See axiom-design (skills/sf-symbols.md)
• HIG compliance → See axiom-design (skills/hig.md)
• Typography → See axiom-design (skills/typography-ref.md)
• TextKit/rich text → See axiom-uikit (skills/textkit-ref.md)

Other

• tvOS (focus, remote, text input) → See axiom-swift (skills/tvos.md)
• App-level composition (root, auth, scenes) → See axiom-design (skills/app-composition.md)
• Drag/drop, sharing, copy/paste → See axiom-swift (skills/transferable-ref.md)
• VoiceOver, Dynamic Type →

  /skill axiom-accessibility

• UI test flakiness →

  /skill axiom-testing

• UX dead ends, dismiss traps → Launch

  ux-flow-auditor

  agent

watchOS-specific patterns

• Glanceable UI, watch navigation, Smart Stack widgets → See axiom-watchos

Conflict Resolution

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

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

Decision Tree

digraph swiftui {
    start [label="SwiftUI issue" shape=ellipse];
    what [label="What's wrong?" shape=diamond];

    start -> what;
    what -> "skills/debugging.md" [label="view not updating"];
    what -> "skills/nav.md" [label="navigation"];
    what -> "skills/swiftui-performance.md" [label="slow/lag"];
    what -> "skills/layout.md" [label="adaptive layout"];
    what -> "skills/containers-ref.md" [label="stacks/grids/outlines"];
    what -> "skills/architecture.md" [label="feature architecture"];
    what -> "skills/animation-ref.md" [label="animations"];
    what -> "skills/gestures.md" [label="gestures"];
    what -> "skills/search-ref.md" [label="search"];
    what -> "skills/26-ref.md" [label="iOS 26 features"];
    what -> "axiom-uikit-bridging" [label="UIKit interop"];
    what -> "axiom-app-composition" [label="app-level (root, auth)"];
    what -> "axiom-transferable-ref" [label="drag/drop, sharing"];
}

Automated Scanning

• Architecture audit → Launch

  swiftui-architecture-auditor

  agent
• Performance scan → Launch

  swiftui-performance-analyzer

  agent or

  /axiom:audit swiftui-performance

• Navigation audit → Launch

  swiftui-nav-auditor

  agent or

  /axiom:audit swiftui-nav

• Layout audit → Launch

  swiftui-layout-auditor

  agent or

  /axiom:audit swiftui-layout

• UX flow audit → Launch

  ux-flow-auditor

  agent or

  /axiom:audit ux-flow

• Liquid Glass scan → Launch

  liquid-glass-auditor

  agent or

  /axiom:audit liquid-glass

• TextKit scan → Launch

  textkit-auditor

  agent or

  /axiom:audit textkit

Anti-Rationalization

skills/layout.md

skills/nav.md

skills/debugging.md

skills/animation-ref.md

skills/architecture.md

skills/search-ref.md