ios-app-design
iOS app design guidelines based on Apple HIG and iOS 26 Liquid Glass. Use when: (1) Designing iOS app interfaces, (2) Reviewing iOS UI code, (3) Building SwiftUI/UIKit views, (4) Adopting Liquid Glass
SKILL.md.claude/skills/ios-app-design/SKILL.md
GitHubiOS App Design
Choose interface behavior that fits the product, target OS, and existing UI framework. Inspect deployment targets and current components before proposing new APIs or visual-system adoption.
Design Criteria
- Use familiar system navigation and controls when they support the task. Preserve established product behavior unless a redesign is requested.
- Keep content readable and actions reachable across supported sizes, orientations, text sizes, and appearances.
- Include accessibility semantics, sufficient contrast, and reduced-motion behavior appropriate to the interaction.
- Give immediate feedback for actions. Distinguish motion polish from actual rendering, network, or input latency.
- Treat Liquid Glass adoption as a compatibility and design decision. Do not replace opaque backgrounds or custom controls merely to match a newer OS style; consider readability, accessibility settings, and the requested scope.
- Apply SwiftUI, UIKit, and React Native examples only within the matching implementation environment. Verify version-sensitive APIs against installed tooling and official Apple documentation before use.
Read by Decision
| Decision | Reference |
|---|---|
| Adopting or tuning Liquid Glass materials | Liquid Glass |
| Choosing tabs, navigation stacks, modals, or search | Navigation |
| Safe areas, adaptive layout, or iPad presentation | Layout |
| Text hierarchy and Dynamic Type | Typography |
| Semantic colors, contrast, or theme behavior | Color and theme |
| Symbols, imagery, or app icons | Icons and imagery |
| Transitions, springs, or gesture continuity | Motion |
| VoiceOver, contrast, and accessibility settings | Accessibility |
| Haptic and visual feedback | Haptics and feedback |
Read only references relevant to the current decision. Their examples and preferred values are starting points, not universal adoption requirements.
Completion
For implementation, inspect the affected interface in the available runtime and check relevant interaction and accessibility states. Use the global test policy; do not add logic tests for visual polish alone.
For review, separate observable usability or accessibility defects from aesthetic suggestions. Report what was inspected and any device or OS coverage gaps; do not claim visual verification from source inspection.