Purpose
Review iOS screens for ios-styleguide compliance, device adaptation, and accessibility. Report issues, then (with approval) fix and run tests to confirm.
Arguments
- •
--focus <feature>— Limit to specific feature folder (default: all Features/) - •
--no-fix— Report only, don't offer to fix
Workflow
1. Collect screens
Scan Features/**/ for *View.swift files to identify screens to review.
2. Evaluate against ios-styleguide
Review each screen for:
Device adaptation
- •iPhone layout: focused, appropriate density
- •iPad layout: uses space intentionally, not stretched iPhone
- •Size class and orientation handling
Liquid Glass
- •Used only for hierarchy/focus (nav bars, sheets, overlays)
- •Not behind dense text, forms, or reading surfaces
- •Respects reduce transparency setting
Typography & hierarchy
- •Clear visual hierarchy
- •Dynamic Type doesn't break layouts
- •No banned fonts as primary
Accessibility
- •VoiceOver labels on custom controls
- •Tap targets ≥44pt
- •Color not sole indicator
"Not generic" bar
- •No unchanged SwiftUI defaults
- •No repetitive patterns without hierarchy
- •Purposeful restraint
For each issue, note:
- •Screen/file
- •Severity:
must-fix|should-fix|nice-to-have - •What violates ios-styleguide
- •Concrete fix
3. Report results
Summary of screens reviewed + findings by severity.
4–5. Approval gate, fix and confirm
See /shared-review-workflow for severity definitions, approval gate protocol, and fix constraints. After fixes, re-run lint/format and run /ios-unit-test.
Reference
For evaluation checklists and preview testing, see reference/ios-design-review-reference.md