audit-swiftui-layout

Scan SwiftUI layout code for patterns that break across device sizes or cause unexpected re-layouts.

What This Command Does

Launches the swiftui-layout-auditor agent to flag layout patterns that look fine on the developer's simulator but break on iPad, landscape, Dynamic Type at maximum, or split-screen multitasking.

What It Checks

1. GeometryReader misuse – using GeometryReader where a layout container would suffice, or for sizing decisions that should respond to environment
2. Deprecated screen APIs – UIScreen.main.bounds and other window-coordinate calls that fail in multi-window contexts
3. Hardcoded breakpoints – magic-number widths instead of horizontalSizeClass or ViewThatFits
4. Identity loss – conditional HStack/VStack swaps that destroy and recreate child views, losing animation continuity
5. Missing safe-area handling – fixed insets that don't account for keyboard, Dynamic Island, or external displays

Related Agent

• swiftui-layout-auditor – The agent that powers this command
• swiftui-layout-ref – SwiftUI layout reference