Apple Platform Design
Platform-specific HIG for Apple operating systems. Use this skill when the user's question depends on device, input model, navigation conventions, or component behavior for iOS and iPadOS, macOS, watchOS, tvOS, or visionOS.
How to use
- Choose the target platform from the selector below. If the user names more than one platform, read each matching glossary and compare only the relevant topics.
- Read the platform glossary first. It maps UI topics to reference files under
references/<platform>/. - Read only the matched references. Multi-file topics (
×N) live inreferences/<platform>/<topic>/. - Pull in
foundationsfor shared principles like color, typography, layout, accessibility, motion, SF Symbols, and shared UI elements. - Pull in
serviceswhen the UI surfaces Apple frameworks or services like Apple Pay, HealthKit, Siri, widgets, sensors, media playback, or Wallet. - Stay platform-specific. Do not generalize a platform convention across Apple platforms unless the matching references agree.
Platform selector
| Platform | Read first | Use when |
|---|---|---|
| iOS and iPadOS | references/ios/glossary.md |
Designing for iPhone or iPad, auditing iOS/iPadOS UI, or checking touch-first component behavior. |
| macOS | references/macos/glossary.md |
Designing for Mac, auditing desktop UI, or checking menu, window, pointer, keyboard, and productivity conventions. |
| watchOS | references/watchos/glossary.md |
Designing for Apple Watch, auditing glanceable UI, or checking Digital Crown, complication, haptic, and compact interaction patterns. |
| tvOS | references/tvos/glossary.md |
Designing for Apple TV, auditing living-room UI, or checking focus, remote, media, and large-screen navigation conventions. |
| visionOS | references/visionos/glossary.md |
Designing for Apple Vision Pro, auditing spatial UI, or checking windows, volumes, immersive experiences, ornaments, and gaze/gesture behavior. |
Routing rules
- If the request is platform-agnostic, use
foundationsinstead. - If the request is about a framework, service, or hardware capability, use
servicesfirst, then come back here for platform-specific UI. - If a topic appears in both a platform reference and
foundations, treat the platform reference as the override for that platform's behavior. - If the user asks for a cross-platform Apple design, compare the relevant platform references explicitly instead of blending them into one rule.