/axiom-swiftui

name: axiom-swiftui
description: Use when building, fixing, or improving ANY SwiftUI UI — views, navigation, layout, animations, performance, architecture, gestures, debugging, iOS 26 features.
license: MIT

SwiftUI

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

<!-- AXIOM_AUDITOR_INLINE_BEGIN — auto-maintained by scripts/build-inlined-auditors.ts; do not hand-edit --> > **Not on Claude Code?** Where this router says "Launch `some-auditor` agent", read that auditor's file in this suite and follow it inline — the same procedure, needing only file search and read. > > Available here: `skills/swiftui-architecture-auditor.md`, `skills/swiftui-layout-auditor.md`, `skills/swiftui-nav-auditor.md`, `skills/swiftui-performance-analyzer.md`, `skills/textkit-auditor.md`, `skills/ux-flow-auditor.md`. > Homed in another suite: `axiom-design/skills/liquid-glass-auditor.md`. > > Agents that need Bash — builds, tests, simulators, crash symbolication — stay Claude Code-only; there is no inline equivalent for those. <!-- AXIOM_AUDITOR_INLINE_END -->

Quick Reference

| Symptom / Task | Reference | |----------------|-----------| | View not updating | See `skills/debugging.md` | | View update still broken after debugging | See `skills/debugging-diag.md` | | Slow previews / building good previews / `@Previewable` / `PreviewModifier` / variant matrix | See `skills/previews.md` | | Preview API reference (`#Preview`, traits, modes, Development Assets) | See `skills/previews-ref.md` | | Preview crashes / won't load | See `skills/debugging.md` (Preview Crashes section) | | Hot reload / live editing / edit the running app on device | See `skills/hot-reload.md` | | Navigation issues | See `skills/nav.md` | | Navigation still broken after debugging | See `skills/nav-diag.md` | | Navigation API reference | See `skills/nav-ref.md` | | Layout breaks on iPad/rotation | See `skills/layout.md` | | State lost on resize/rotation (scroll, selection, focus, drafts) | See `skills/layout.md` (State Survives the Transition) | | Layout API reference | See `skills/layout-ref.md` | | Performance/lag/slow scroll | See `skills/swiftui-performance.md` | | Architecture/testability | See `skills/architecture.md` | | Animation issues | See `skills/animation-ref.md` | | Stacks/grids/outlines | See `skills/containers-ref.md` | | Custom containers / List replacement (iOS 18+) | See `skills/containers-ref.md` Part 7 | | Search implementation | See `skills/search-ref.md` | | Toolbars, ToolbarItem, sheet button placement, customization | See `skills/toolbars.md` | | Sheets, detents, popovers, fullScreenCover, presentation adaptation | See `skills/presentations.md` | | Multi-column Table, sortable/resizable columns (iPad/Mac; collapses to first column in compact) | See axiom-macos (skills/swiftui-differences.md) | | Inspector panel (`.inspector` — trailing column in regular width, sheet in compact) | See axiom-macos (skills/swiftui-differences.md) | | Gesture conflicts | See `skills/gestures.md` | | iOS 26 features | See `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/toolbars.md" [label="toolbars / sheet buttons"];
    what -> "skills/presentations.md" [label="sheets/detents/popovers"];
    what -> "skills/26-ref.md" [label="iOS 26 features"];
    what -> "skills/previews.md" [label="slow previews / building good previews"];
    what -> "skills/previews-ref.md" [label="preview API reference"];
    what -> "skills/debugging.md" [label="preview crashes / won't load"];
    what -> "skills/hot-reload.md" [label="hot reload / live editing"];
    what -> "axiom-macos (skills/swiftui-differences.md)"