What problem does it solve?
Provide a systematic, code-driven visual design review for SwiftUI-based app screens to catch weak visual hierarchy, conflicting color emphasis, inconsistent spacing, token misuse, and macOS-specific layout issues before visual optimization or release.
Core Features & Use Cases
- Code-verified checks: Automated analysis of SwiftUI modifiers to validate font hierarchy, color strategy, spacing rhythm, alignment, card/container rules, icon consistency, navigation depth, and interaction feedback with file:line references.
- Reference-driven: Loads project references such as ui-design-principles.md and apple-ui-checklist.md to enforce project-specific thresholds and platform-specific rules.
- Cross-file comparison & reports: Compares similarly named components across files for consistent tokens and produces a Design Review Report with prioritized 🔴/🟡 findings and a device validation checklist for manual visual checks.
- Safe workflow: Complements /ui-review and /feature-review, recommends fixes but requires explicit user confirmation before any code modification.
- Use cases: Run after completing a page/module UI, before visual polishing, during pre-release QA, or as part of a design handoff.
Quick Start
Run a design review on the changed SwiftUI view files and produce a code-referenced report that highlights visual hierarchy, color strategy, spacing, and design-token issues.