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

GitHub

iOS 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.