iOS Design Review

Validate SwiftUI/UIKit code against Apple Human Interface Guidelines.

When to Use

• After generating SwiftUI components

• Before submitting iOS code for review

• Auditing existing iOS UI code

• Checking accessibility compliance

Review Checklist

1. Colors & Theming

• Uses semantic colors (Color.primary , Color(.systemBackground) )

• No hardcoded hex colors

• Works in both Light and Dark mode

• High contrast mode support

2. Typography

• Uses system fonts (San Francisco)

• Supports Dynamic Type

• Proper text styles (.headline , .body , .caption )

• No fixed font sizes for body text

3. Touch Targets

• Minimum 44×44 points for interactive elements

• Adequate spacing between tappable items (12-24pt)

• No gesture conflicts with system gestures

4. Accessibility

• VoiceOver labels on icon-only buttons

• accessibilityElement(children: .combine) for grouped content

• accessibilityHidden(true) for decorative elements

• Meaningful accessibility hints where needed

5. Navigation

• Tab bar for 2-5 primary destinations (not actions)

• Navigation titles present

• Back button behavior correct

• Modal dismiss patterns (swipe, X button)

6. SF Symbols

• Uses SF Symbols over custom icons where possible

• Correct rendering mode (monochrome/hierarchical/palette)

• Symbols scale with Dynamic Type

7. Layout

• Safe area respected

• Adapts to different screen sizes

• Proper keyboard avoidance

• No content clipping

Review Output Format

HIG Compliance Review

File: Views/SettingsView.swift

Issues Found

Critical

• Line 45: Touch target too small (32×32pt) Fix: Add .frame(minWidth: 44, minHeight: 44)

Warnings

• Line 23: Hardcoded color Color(hex: "#FF5733") Fix: Use Color.accentColor or semantic color

Suggestions

• Line 67: Consider adding accessibilityLabel to icon button

Summary

• Critical: 1
• Warnings: 1
• Suggestions: 1
• Overall: Needs fixes before shipping

Common Issues

Color Issues

// ❌ Problem Text("Hello").foregroundColor(Color(hex: "#333333"))

// ✅ Fix Text("Hello").foregroundStyle(.primary)

Touch Target Issues

// ❌ Problem Button { } label: { Image(systemName: "plus") }

// ✅ Fix Button { } label: { Image(systemName: "plus") .frame(minWidth: 44, minHeight: 44) }

Accessibility Issues

// ❌ Problem Button { delete() } label: { Image(systemName: "trash") }

// ✅ Fix Button { delete() } label: { Image(systemName: "trash") } .accessibilityLabel("Delete item")

Usage

User: Review this SwiftUI view for HIG compliance [pastes code]

Claude: [Runs checklist against code]

• Identifies issues by category
• Provides specific line numbers
• Suggests fixes with code examples

Related Skills

• ios-swiftui-generator — Generate compliant code

• ios-hig-reference — Full HIG reference