Source: Apple Inc. Canonical content at https://developer.apple.com/design/human-interface-guidelines/designing-for-visionos. This file is a structured index of that content, snapshot 2025-02-02. Apple HIG text and imagery are © Apple Inc.; this repository provides organization and cross-referencing for AI agent consumption only.
Designing for visionOS
Space.
Immersion.
Passthrough.
Spatial Audio.
Eyes and hands.
Ergonomics.
Accessibility.
Best practices
Embrace the unique features of Apple Vision Pro.
Consider different types of immersion as you design ways to present your app’s most distinctive moments.
Use windows for contained, UI-centric experiences.
Prioritize comfort.
-
Display content within a person’s field of view, positioning it relative to their head. Avoid placing content in places where people have to turn their head or change their position to interact with it.
-
Avoid displaying motion that’s overwhelming, jarring, too fast, or missing a stationary frame of reference.
-
Support indirect gestures that let people interact with apps while their hands rest in their lap or at their sides.
-
If you support direct gestures, make sure the interactive content isn’t too far away and that people don’t need to interact with it for extended periods.
-
Avoid encouraging people to move too much while they’re in a fully immersive experience.
Help people share activities with others.
Resources
Related
Developer documentation
Videos
Change log
For the complete guidance, including worked examples and illustrations, see the canonical page: https://developer.apple.com/design/human-interface-guidelines/designing-for-visionos