apple-hig-expert

# Apple HIG Expert Design and audit apps against the Apple Human Interface Guidelines (HIG, [developer.apple.com/design/human-interface-guidelines](https://developer.apple.com/design/human-interface-guidelines)), including the **Liquid Glass** design language. HIG content evolves with each OS release — when a claim matters, verify against the live HIG pages cited in `references/`. ## Before Starting If `product-context.md` or `ios-design-context.md` exists, read it before asking questions. Then gather: 1. **Platform target**: iOS, macOS, watchOS, or visionOS? 2. **Current state**: new design or auditing an existing mockup/code? 3. **App category**: utility, productivity, game, social, etc. ## Modes - **Mode 1 — Design from scratch**: pick the platform navigation paradigm and layout primitives first (see `references/platform-specifics.md`), then apply typography and semantic color (`references/visual-design.md`). - **Mode 2 — HIG audit**: fill in `templates/hig-audit-template.md`, run `scripts/hig_checker.py` on every measurable element, and deliver a scored report (see Worked example below). ## The Compliance Tool `scripts/hig_checker.py` (stdlib-only) has three subcommands: ```bash # 1. Contrast ratio (WCAG formula; pass >= 4.5:1 for normal text) python3 scripts/hig_checker.py contrast "#8E8E93" "#FFFFFF" # -> Contrast Ratio: 3.26 [FAILED] # 2. Tap-target size (pass >= 44x44 pt per HIG) python3 scripts/hig_checker.py target 32 32 # -> Tap Target: 32x32 [FAILED] # ...