# IOS Design Review

> Visual design review of iOS screens against ios-styleguide. Use when this capability is needed.

- Skill: `tomevault-io/ios-design-review` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/ios-design-review`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/ios-design-review/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/ios-design-review

---


## 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`

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/edfenton) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->