{"abstract":[{"text":"When people wear Apple Vision Pro, they enter an infinite 3D space where they can engage with your app or game while staying connected to their surroundings.","type":"text"}],"hierarchy":{"paths":[["doc:\/\/com.apple.documentation\/documentation\/technologies","doc:\/\/com.apple.HIG\/design\/human-interface-guidelines","doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/getting-started"]]},"identifier":{"interfaceLanguage":"swift","url":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/designing-for-visionos"},"kind":"article","legalNotices":{"copyright":"Copyright &copy; 2026 Apple Inc. All rights reserved.","privacyPolicy":"https:\/\/www.apple.com\/privacy\/privacy-policy","termsOfUse":"https:\/\/www.apple.com\/legal\/internet-services\/terms\/site.html"},"metadata":{"availableLanguages":["en-US","zh-CN","ja-JP","ko-KR"],"customMetadata":{"alert-date":"2024-02-02","alert-text":"Included a link to Apple&nbsp;Vision&nbsp;Pro User Guide."},"images":[{"identifier":"visionos.svg","type":"icon"},{"identifier":"platforms-designing-for-visionos-thumbnail.png","type":"card"}],"role":"article","title":"Designing for visionOS"},"primaryContentSections":[{"content":[{"inlineContent":[{"identifier":"platforms-visionOS-intro.png","type":"image"}],"type":"paragraph"},{"inlineContent":[{"text":"As you begin designing your app or game for visionOS, start by understanding the fundamental device characteristics and patterns that distinguish the platform. Use these characteristics and patterns to inform your design decisions and help you create immersive and engaging experiences.","type":"text"}],"type":"paragraph"},{"inlineContent":[{"inlineContent":[{"text":"Space.","type":"text"}],"type":"strong"},{"text":" Apple Vision Pro offers a limitless canvas where people can view virtual content like ","type":"text"},{"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/windows","isActive":true,"overridingTitle":"windows","overridingTitleInlineContent":[{"text":"windows","type":"text"}],"type":"reference"},{"text":", ","type":"text"},{"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/windows#visionOS-volumes","isActive":true,"overridingTitle":"volumes","overridingTitleInlineContent":[{"text":"volumes","type":"text"}],"type":"reference"},{"text":", and 3D objects, and choose to enter deeply immersive experiences that can transport them to different places.","type":"text"}],"type":"paragraph"},{"inlineContent":[{"inlineContent":[{"text":"Immersion.","type":"text"}],"type":"strong"},{"text":" In a visionOS app, people can fluidly transition between different levels of ","type":"text"},{"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/immersive-experiences","isActive":true,"overridingTitle":"immersion","overridingTitleInlineContent":[{"text":"immersion","type":"text"}],"type":"reference"},{"text":". By default, an app launches in the ","type":"text"},{"inlineContent":[{"text":"Shared Space","type":"text"}],"type":"emphasis"},{"text":" where multiple apps can run side-by-side and people can open, close, and relocate windows. People can also choose to transition an app to a ","type":"text"},{"inlineContent":[{"text":"Full Space","type":"text"}],"type":"emphasis"},{"text":", where it’s the only app running.  While in a Full Space app, people can view 3D content blended with their surroundings, open a portal to view another place, or enter a different world.","type":"text"}],"type":"paragraph"},{"inlineContent":[{"inlineContent":[{"text":"Passthrough.","type":"text"}],"type":"strong"},{"text":" ","type":"text"},{"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/immersive-experiences#Immersion-and-passthrough","isActive":true,"overridingTitle":"Passthrough","overridingTitleInlineContent":[{"text":"Passthrough","type":"text"}],"type":"reference"},{"text":" provides live video from the device’s external cameras, and helps people interact with virtual content while also seeing their actual surroundings. When people want to see more or less of their surroundings, they use the ","type":"text"},{"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/digital-crown","isActive":true,"type":"reference"},{"text":" to control the amount of passthrough.","type":"text"}],"type":"paragraph"},{"inlineContent":[{"inlineContent":[{"text":"Spatial Audio.","type":"text"}],"type":"strong"},{"text":" Apple Vision Pro combines acoustic and visual-sensing technologies to model the sonic characteristics of a person’s surroundings, automatically making audio sound natural in their space. When an app receives a person’s permission to access information about their surroundings, it can fine-tune ","type":"text"},{"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/playing-audio#visionOS","isActive":true,"overridingTitle":"Spatial Audio","overridingTitleInlineContent":[{"text":"Spatial Audio","type":"text"}],"type":"reference"},{"text":" to bring custom experiences to life.","type":"text"}],"type":"paragraph"},{"inlineContent":[{"inlineContent":[{"text":"Eyes and hands.","type":"text"}],"type":"strong"},{"text":" In general, people perform most actions by using their ","type":"text"},{"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/eyes","isActive":true,"overridingTitle":"eyes","overridingTitleInlineContent":[{"text":"eyes","type":"text"}],"type":"reference"},{"text":" to look at a virtual object and making an ","type":"text"},{"inlineContent":[{"text":"indirect","type":"text"}],"type":"emphasis"},{"text":" ","type":"text"},{"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/gestures#visionOS","isActive":true,"overridingTitle":"gesture","overridingTitleInlineContent":[{"text":"gesture","type":"text"}],"type":"reference"},{"text":", like a tap, to activate it. People can also interact with a virtual object by using a ","type":"text"},{"inlineContent":[{"text":"direct","type":"text"}],"type":"emphasis"},{"text":" gesture, like touching it with a finger.","type":"text"}],"type":"paragraph"},{"inlineContent":[{"inlineContent":[{"text":"Ergonomics.","type":"text"}],"type":"strong"},{"text":" While wearing Apple Vision Pro, people rely entirely on the device’s cameras for everything they see, both real and virtual, so maintaining visual comfort is paramount. The system helps maintain comfort by automatically placing content so it’s relative to the wearer’s head, regardless of the person’s height or whether they’re sitting, standing, or lying down. Because visionOS brings content to people — instead of making people move to reach the content — people can remain at rest while engaging with apps and games.","type":"text"}],"type":"paragraph"},{"inlineContent":[{"inlineContent":[{"text":"Accessibility.","type":"text"}],"type":"strong"},{"text":" Apple Vision Pro supports ","type":"text"},{"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/accessibility","isActive":true,"overridingTitle":"accessibility","overridingTitleInlineContent":[{"text":"accessibility","type":"text"}],"type":"reference"},{"text":" technologies like VoiceOver, Switch Control, Dwell Control, Guided Access, Head Pointer, and many more, so people can use the interactions that work for them. In visionOS, as in all platforms, system-provided UI components build in accessibility support by default, while system frameworks give you ways to enhance the accessibility of your app or game.","type":"text"}],"type":"paragraph"},{"content":[{"inlineContent":[{"text":"When building your app for Apple Vision Pro, be sure to consider the unique characteristics of the device and its spatial computing environment, and pay special attention to your user’s safety; for more details about these characteristics, see ","type":"text"},{"identifier":"https:\/\/support.apple.com\/guide\/apple-vision-pro","isActive":true,"type":"reference"},{"text":". For example, Apple Vision Pro should not be used while operating a vehicle or heavy machinery. The device is also not designed to be used while moving around unsafe environments such as near balconies, streets, stairs, or other potential hazards. Note that Apple Vision Pro is designed to be fit and used only by individuals 13 years of age or older.","type":"text"}],"type":"paragraph"}],"name":"Important","style":"important","type":"aside"},{"anchor":"Best-practices","level":2,"text":"Best practices","type":"heading"},{"inlineContent":[{"text":"Great visionOS apps and games are approachable and familiar, while offering extraordinary experiences that can surround people with beautiful content, expanded capabilities, and captivating adventures.","type":"text"}],"type":"paragraph"},{"inlineContent":[{"inlineContent":[{"text":"Embrace the unique features of Apple Vision Pro.","type":"text"}],"type":"strong"},{"text":" Take advantage of space, Spatial Audio, and immersion to bring life to your experiences, while integrating passthrough and spatial input from eyes and hands in ways that feel at home on the device.","type":"text"}],"type":"paragraph"},{"inlineContent":[{"inlineContent":[{"text":"Consider different types of immersion as you design ways to present your app’s most distinctive moments.","type":"text"}],"type":"strong"},{"text":" You can present experiences in a windowed, UI-centric context, a fully immersive context, or something in between. For each key moment in your app, find the minimum level of immersion that suits it best — don’t assume that every moment needs to be fully immersive.","type":"text"}],"type":"paragraph"},{"inlineContent":[{"inlineContent":[{"text":"Use windows for contained, UI-centric experiences.","type":"text"}],"type":"strong"},{"text":" To help people perform standard tasks, prefer standard ","type":"text"},{"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/windows#visionOS","isActive":true,"overridingTitle":"windows","overridingTitleInlineContent":[{"text":"windows","type":"text"}],"type":"reference"},{"text":" that appear as planes in space and contain familiar controls. In visionOS, people can relocate windows anywhere they want, and the system’s ","type":"text"},{"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/spatial-layout#Scale","isActive":true,"overridingTitle":"dynamic scaling","overridingTitleInlineContent":[{"text":"dynamic scaling","type":"text"}],"type":"reference"},{"text":" helps keep window content legible whether it’s near or far.","type":"text"}],"type":"paragraph"},{"inlineContent":[{"inlineContent":[{"text":"Prioritize comfort.","type":"text"}],"type":"strong"},{"text":" To help people stay comfortable and physically relaxed as they interact with your app or game, keep the following fundamentals in mind.","type":"text"}],"type":"paragraph"},{"items":[{"content":[{"inlineContent":[{"text":"Display content within a person’s ","type":"text"},{"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/spatial-layout#Field-of-view","isActive":true,"overridingTitle":"field of view","overridingTitleInlineContent":[{"text":"field of view","type":"text"}],"type":"reference"},{"text":", 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.","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Avoid displaying ","type":"text"},{"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/motion#visionOS","isActive":true,"overridingTitle":"motion","overridingTitleInlineContent":[{"text":"motion","type":"text"}],"type":"reference"},{"text":" that’s overwhelming, jarring, too fast, or missing a stationary frame of reference.","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Support ","type":"text"},{"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/gestures#visionOS","isActive":true,"overridingTitle":"indirect gestures","overridingTitleInlineContent":[{"text":"indirect gestures","type":"text"}],"type":"reference"},{"text":" that let people interact with apps while their hands rest in their lap or at their sides.","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"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.","type":"text"}],"type":"paragraph"}]},{"content":[{"inlineContent":[{"text":"Avoid encouraging people to move too much while they’re in a fully ","type":"text"},{"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/immersive-experiences","isActive":true,"overridingTitle":"immersive experience","overridingTitleInlineContent":[{"text":"immersive experience","type":"text"}],"type":"reference"},{"text":".","type":"text"}],"type":"paragraph"}]}],"type":"unorderedList"},{"inlineContent":[{"inlineContent":[{"text":"Help people share activities with others.","type":"text"}],"type":"strong"},{"text":" When you use ","type":"text"},{"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/shareplay#visionOS","isActive":true,"overridingTitle":"SharePlay","overridingTitleInlineContent":[{"text":"SharePlay","type":"text"}],"type":"reference"},{"text":" to support shared activities, people can view the ","type":"text"},{"inlineContent":[{"text":"spatial Personas","type":"text"}],"type":"emphasis"},{"text":" of other participants, making it feel like everyone is together in the same space.","type":"text"}],"type":"paragraph"},{"anchor":"Resources","level":2,"text":"Resources","type":"heading"},{"anchor":"Related","level":4,"text":"Related","type":"heading"},{"inlineContent":[{"identifier":"https:\/\/developer.apple.com\/design\/resources\/#visionos-apps","isActive":true,"type":"reference"}],"type":"paragraph"},{"anchor":"Developer-documentation","level":4,"text":"Developer documentation","type":"heading"},{"inlineContent":[{"identifier":"https:\/\/developer.apple.com\/visionos\/get-started\/","isActive":true,"type":"reference"}],"type":"paragraph"},{"inlineContent":[{"identifier":"doc:\/\/com.apple.documentation\/documentation\/visionOS\/creating-your-first-visionos-app","isActive":true,"type":"reference"}],"type":"paragraph"},{"anchor":"Videos","level":4,"text":"Videos","type":"heading"},{"items":["doc:\/\/com.apple.documentation\/videos\/play\/wwdc2024\/10096","doc:\/\/com.apple.documentation\/videos\/play\/wwdc2024\/10086","doc:\/\/com.apple.documentation\/videos\/play\/wwdc2023\/10072"],"style":"compactGrid","type":"links"},{"anchor":"Change-log","level":2,"text":"Change log","type":"heading"},{"header":"row","rows":[[[{"inlineContent":[{"text":"Date","type":"text"}],"type":"paragraph"}],[{"inlineContent":[{"text":"Changes","type":"text"}],"type":"paragraph"}]],[[{"inlineContent":[{"text":"February 2, 2024","type":"text"}],"type":"paragraph"}],[{"inlineContent":[{"text":"Included a link to Apple Vision Pro User Guide.","type":"text"}],"type":"paragraph"}]],[[{"inlineContent":[{"text":"September 12, 2023","type":"text"}],"type":"paragraph"}],[{"inlineContent":[{"text":"Updated intro artwork.","type":"text"}],"type":"paragraph"}]],[[{"inlineContent":[{"text":"June 21, 2023","type":"text"}],"type":"paragraph"}],[{"inlineContent":[{"text":"New page.","type":"text"}],"type":"paragraph"}]]],"type":"table"}],"kind":"content"}],"schemaVersion":{"major":0,"minor":3,"patch":0},"sections":[],"topicSectionsStyle":"compactGrid","references":{"15489B11-8744-483D-AD38-EF78D8962FF4":{"alt":null,"identifier":"15489B11-8744-483D-AD38-EF78D8962FF4","type":"image","variants":[{"traits":["1x"],"url":"https:\/\/devimages-cdn.apple.com\/wwdc-services\/images\/D35E0E85-CCB6-41A1-B227-7995ECD83ED5\/15489B11-8744-483D-AD38-EF78D8962FF4\/8126_wide_250x141_1x.jpg"},{"traits":["2x"],"url":"https:\/\/devimages-cdn.apple.com\/wwdc-services\/images\/D35E0E85-CCB6-41A1-B227-7995ECD83ED5\/15489B11-8744-483D-AD38-EF78D8962FF4\/8126_wide_250x141_2x.jpg"},{"traits":["3x"],"url":"https:\/\/devimages-cdn.apple.com\/wwdc-services\/images\/D35E0E85-CCB6-41A1-B227-7995ECD83ED5\/15489B11-8744-483D-AD38-EF78D8962FF4\/8126_wide_250x141_3x.jpg"}]},"A207EE2A-D9E6-4FAB-A557-ABEAA68840AB":{"alt":null,"identifier":"A207EE2A-D9E6-4FAB-A557-ABEAA68840AB","type":"image","variants":[{"traits":["1x"],"url":"https:\/\/devimages-cdn.apple.com\/wwdc-services\/images\/C03E6E6D-A32A-41D0-9E50-C3C6059820AA\/A207EE2A-D9E6-4FAB-A557-ABEAA68840AB\/9197_wide_250x141_1x.jpg"},{"traits":["2x"],"url":"https:\/\/devimages-cdn.apple.com\/wwdc-services\/images\/C03E6E6D-A32A-41D0-9E50-C3C6059820AA\/A207EE2A-D9E6-4FAB-A557-ABEAA68840AB\/9197_wide_250x141_2x.jpg"},{"traits":["3x"],"url":"https:\/\/devimages-cdn.apple.com\/wwdc-services\/images\/C03E6E6D-A32A-41D0-9E50-C3C6059820AA\/A207EE2A-D9E6-4FAB-A557-ABEAA68840AB\/9197_wide_250x141_3x.jpg"}]},"B2E0763D-C5D2-4191-AC0B-F99D56BE781F":{"alt":null,"identifier":"B2E0763D-C5D2-4191-AC0B-F99D56BE781F","type":"image","variants":[{"traits":["1x"],"url":"https:\/\/devimages-cdn.apple.com\/wwdc-services\/images\/C03E6E6D-A32A-41D0-9E50-C3C6059820AA\/B2E0763D-C5D2-4191-AC0B-F99D56BE781F\/9208_wide_250x141_1x.jpg"},{"traits":["2x"],"url":"https:\/\/devimages-cdn.apple.com\/wwdc-services\/images\/C03E6E6D-A32A-41D0-9E50-C3C6059820AA\/B2E0763D-C5D2-4191-AC0B-F99D56BE781F\/9208_wide_250x141_2x.jpg"},{"traits":["3x"],"url":"https:\/\/devimages-cdn.apple.com\/wwdc-services\/images\/C03E6E6D-A32A-41D0-9E50-C3C6059820AA\/B2E0763D-C5D2-4191-AC0B-F99D56BE781F\/9208_wide_250x141_3x.jpg"}]},"Creating-your-first-visionOS-app-PageImage-card.png":{"alt":"A photograph of an Apple Vision Pro from the front with a subtle glow behind it.","identifier":"Creating-your-first-visionOS-app-PageImage-card.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.visionOS\/Creating-your-first-visionOS-app-PageImage-card@2x.png"},{"traits":["2x","dark"],"url":"\/images\/com.apple.visionOS\/Creating-your-first-visionOS-app-PageImage-card~dark@2x.png"}]},"accessibility.svg":{"alt":"The Accessibility icon.","identifier":"accessibility.svg","type":"image","variants":[{"svgID":"accessibility","traits":["1x","light"],"url":"\/images\/com.apple.HIG\/accessibility.svg"}]},"components-windows-thumbnail.png":{"alt":"A stylized representation of a window with close, minimize, and full-screen buttons. The image is tinted red to subtly reflect the red in the original six-color Apple logo.","identifier":"components-windows-thumbnail.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/components-windows-thumbnail@2x.png"},{"traits":["2x","dark"],"url":"\/images\/com.apple.HIG\/components-windows-thumbnail~dark@2x.png"}]},"digital-crown.svg":{"alt":"An icon of a curved arrow beside a Digital Crown that suggests turning the Digital Crown.","identifier":"digital-crown.svg","type":"image","variants":[{"svgID":"digital-crown","traits":["1x","light"],"url":"\/images\/com.apple.HIG\/digital-crown.svg"}]},"doc://com.apple.HIG/design/Human-Interface-Guidelines/accessibility":{"abstract":[{"text":"Accessible user interfaces empower everyone to have a great experience with your app or game.","type":"text"}],"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/accessibility","images":[{"identifier":"accessibility.svg","type":"icon"},{"identifier":"foundations-accessibility-thumbnail.png","type":"card"}],"kind":"article","role":"article","title":"Accessibility","type":"topic","url":"\/design\/human-interface-guidelines\/accessibility"},"doc://com.apple.HIG/design/Human-Interface-Guidelines/digital-crown":{"abstract":[{"text":"The Digital Crown is an important hardware input for Apple Vision Pro and Apple Watch.","type":"text"}],"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/digital-crown","images":[{"identifier":"digital-crown.svg","type":"icon"},{"identifier":"inputs-digital-crown-thumbnail.png","type":"card"}],"kind":"article","role":"article","title":"Digital Crown","type":"topic","url":"\/design\/human-interface-guidelines\/digital-crown"},"doc://com.apple.HIG/design/Human-Interface-Guidelines/eyes":{"abstract":[{"text":"In visionOS, people look at a virtual object to identify it as a target they can interact with.","type":"text"}],"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/eyes","images":[{"identifier":"eyes.svg","type":"icon"},{"identifier":"inputs-eyes-thumbnail.png","type":"card"}],"kind":"article","role":"article","title":"Eyes","type":"topic","url":"\/design\/human-interface-guidelines\/eyes"},"doc://com.apple.HIG/design/Human-Interface-Guidelines/gestures#visionOS":{"abstract":[],"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/gestures#visionOS","kind":"section","title":"visionOS","type":"topic","url":"\/design\/human-interface-guidelines\/gestures#visionOS"},"doc://com.apple.HIG/design/Human-Interface-Guidelines/getting-started":{"abstract":[{"text":"Create an app or game that feels at home on every platform you support.","type":"text"}],"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/getting-started","images":[{"identifier":"overview.svg","type":"icon"},{"identifier":"platforms.png","type":"card"}],"kind":"article","role":"collectionGroup","title":"Getting started","type":"topic","url":"\/design\/human-interface-guidelines\/getting-started"},"doc://com.apple.HIG/design/Human-Interface-Guidelines/immersive-experiences":{"abstract":[{"text":"In visionOS, you can design apps and games that extend beyond windows and volumes, immersing people in your content.","type":"text"}],"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/immersive-experiences","images":[{"identifier":"immersive-experiences.svg","type":"icon"},{"identifier":"foundations-immersive-experiences-thumbnail.png","type":"card"}],"kind":"article","role":"article","title":"Immersive experiences","type":"topic","url":"\/design\/human-interface-guidelines\/immersive-experiences"},"doc://com.apple.HIG/design/Human-Interface-Guidelines/immersive-experiences#Immersion-and-passthrough":{"abstract":[],"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/immersive-experiences#Immersion-and-passthrough","kind":"section","title":"Immersion and passthrough","type":"topic","url":"\/design\/human-interface-guidelines\/immersive-experiences#Immersion-and-passthrough"},"doc://com.apple.HIG/design/Human-Interface-Guidelines/motion#visionOS":{"abstract":[],"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/motion#visionOS","kind":"section","title":"visionOS","type":"topic","url":"\/design\/human-interface-guidelines\/motion#visionOS"},"doc://com.apple.HIG/design/Human-Interface-Guidelines/playing-audio#visionOS":{"abstract":[],"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/playing-audio#visionOS","kind":"section","title":"visionOS","type":"topic","url":"\/design\/human-interface-guidelines\/playing-audio#visionOS"},"doc://com.apple.HIG/design/Human-Interface-Guidelines/shareplay#visionOS":{"abstract":[],"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/shareplay#visionOS","kind":"section","title":"visionOS","type":"topic","url":"\/design\/human-interface-guidelines\/shareplay#visionOS"},"doc://com.apple.HIG/design/Human-Interface-Guidelines/spatial-layout#Field-of-view":{"abstract":[],"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/spatial-layout#Field-of-view","kind":"section","title":"Field of view","type":"topic","url":"\/design\/human-interface-guidelines\/spatial-layout#Field-of-view"},"doc://com.apple.HIG/design/Human-Interface-Guidelines/spatial-layout#Scale":{"abstract":[],"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/spatial-layout#Scale","kind":"section","title":"Scale","type":"topic","url":"\/design\/human-interface-guidelines\/spatial-layout#Scale"},"doc://com.apple.HIG/design/Human-Interface-Guidelines/windows":{"abstract":[{"text":"A window presents UI views and components in your app or game.","type":"text"}],"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/windows","images":[{"identifier":"components-windows-thumbnail.png","type":"card"}],"kind":"article","role":"article","title":"Windows","type":"topic","url":"\/design\/human-interface-guidelines\/windows"},"doc://com.apple.HIG/design/Human-Interface-Guidelines/windows#visionOS":{"abstract":[],"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/windows#visionOS","kind":"section","title":"visionOS","type":"topic","url":"\/design\/human-interface-guidelines\/windows#visionOS"},"doc://com.apple.HIG/design/Human-Interface-Guidelines/windows#visionOS-volumes":{"abstract":[],"identifier":"doc:\/\/com.apple.HIG\/design\/Human-Interface-Guidelines\/windows#visionOS-volumes","kind":"section","title":"visionOS volumes","type":"topic","url":"\/design\/human-interface-guidelines\/windows#visionOS-volumes"},"doc://com.apple.HIG/design/human-interface-guidelines":{"abstract":[{"text":"The HIG contains guidance and best practices that can help you design a","type":"text"},{"text":" ","type":"text"},{"text":"great experience for any Apple platform.","type":"text"}],"identifier":"doc:\/\/com.apple.HIG\/design\/human-interface-guidelines","images":[{"identifier":"human-interface-guidelines-page-image-card.png","type":"card"}],"kind":"article","role":"collection","title":"Human Interface Guidelines","type":"topic","url":"\/design\/human-interface-guidelines"},"doc://com.apple.documentation/documentation/technologies":{"abstract":[],"identifier":"doc:\/\/com.apple.documentation\/documentation\/technologies","kind":"technologies","role":"overview","title":"Technologies","type":"topic","url":"\/documentation\/technologies"},"doc://com.apple.documentation/documentation/visionOS/creating-your-first-visionos-app":{"abstract":[{"text":"Build a new visionOS app using SwiftUI and add platform-specific features.","type":"text"}],"identifier":"doc:\/\/com.apple.documentation\/documentation\/visionOS\/creating-your-first-visionos-app","images":[{"identifier":"Creating-your-first-visionOS-app-PageImage-card.png","type":"card"}],"kind":"article","role":"article","title":"Creating your first visionOS app","type":"topic","url":"\/documentation\/visionos\/creating-your-first-visionos-app"},"doc://com.apple.documentation/videos/play/wwdc2023/10072":{"abstract":[{"text":"Discover the fundamentals of spatial design. Learn how to design with depth, scale, windows, and immersion, and apply best practices for creating comfortable, human-centered experiences that transform reality. Find out how you can use these spatial design principles to extend your existing app or bring a new idea to life.","type":"text"}],"identifier":"doc:\/\/com.apple.documentation\/videos\/play\/wwdc2023\/10072","images":[{"identifier":"15489B11-8744-483D-AD38-EF78D8962FF4","type":"card"}],"kind":"article","role":"article","title":"Principles of spatial design","type":"topic","url":"https:\/\/developer.apple.com\/videos\/play\/wwdc2023\/10072"},"doc://com.apple.documentation/videos/play/wwdc2024/10086":{"abstract":[{"text":"Find out how to create compelling spatial computing apps by embracing immersion, designing for eyes and hands, and taking advantage of depth, scale, and space. We’ll share several examples of great visionOS apps and explore how their designers approached creating new experiences for the platform.","type":"text"}],"identifier":"doc:\/\/com.apple.documentation\/videos\/play\/wwdc2024\/10086","images":[{"identifier":"A207EE2A-D9E6-4FAB-A557-ABEAA68840AB","type":"card"}],"kind":"article","role":"article","title":"Design great visionOS apps","type":"topic","url":"https:\/\/developer.apple.com\/videos\/play\/wwdc2024\/10086"},"doc://com.apple.documentation/videos/play/wwdc2024/10096":{"abstract":[{"text":"Learn how you can design a compelling interactive narrative experience for Apple Vision Pro from the designers of Encounter Dinosaurs. Discover how these types of experiences differ from existing apps, media, and games, and explore how to design narratives that bring audiences into new worlds. Find out how you can create stories that adapt to any space and size, provide multiple levels of interaction to make them accessible to all, and use animation, spatial audio, and custom gestures to further immerse people in your experience.","type":"text"}],"identifier":"doc:\/\/com.apple.documentation\/videos\/play\/wwdc2024\/10096","images":[{"identifier":"B2E0763D-C5D2-4191-AC0B-F99D56BE781F","type":"card"}],"kind":"article","role":"article","title":"Design interactive experiences for visionOS","type":"topic","url":"https:\/\/developer.apple.com\/videos\/play\/wwdc2024\/10096"},"eyes.svg":{"alt":"An icon of a human eye.","identifier":"eyes.svg","type":"image","variants":[{"svgID":"Design-Spec","traits":["1x","light"],"url":"\/images\/com.apple.HIG\/eyes.svg"}]},"foundations-accessibility-thumbnail.png":{"alt":"A sketch of the Accessibility icon. The image is tinted yellow to subtly reflect the yellow in the original six-color Apple logo.","identifier":"foundations-accessibility-thumbnail.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/foundations-accessibility-thumbnail@2x.png"},{"traits":["2x","dark"],"url":"\/images\/com.apple.HIG\/foundations-accessibility-thumbnail~dark@2x.png"}]},"foundations-immersive-experiences-thumbnail.png":{"alt":"A sketch that suggests Apple Vision Pro. The image is tinted yellow to subtly reflect the yellow in the original six-color Apple logo.","identifier":"foundations-immersive-experiences-thumbnail.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/foundations-immersive-experiences-thumbnail@2x.png"},{"traits":["2x","dark"],"url":"\/images\/com.apple.HIG\/foundations-immersive-experiences-thumbnail~dark@2x.png"}]},"https://developer.apple.com/design/resources/#visionos-apps":{"identifier":"https:\/\/developer.apple.com\/design\/resources\/#visionos-apps","title":"Apple Design Resources","titleInlineContent":[{"text":"Apple Design Resources","type":"text"}],"type":"link","url":"https:\/\/developer.apple.com\/design\/resources\/#visionos-apps"},"https://developer.apple.com/visionos/get-started/":{"identifier":"https:\/\/developer.apple.com\/visionos\/get-started\/","title":"visionOS Pathway","titleInlineContent":[{"text":"visionOS Pathway","type":"text"}],"type":"link","url":"https:\/\/developer.apple.com\/visionos\/get-started\/"},"https://support.apple.com/guide/apple-vision-pro":{"identifier":"https:\/\/support.apple.com\/guide\/apple-vision-pro","title":"Apple Vision Pro User Guide","titleInlineContent":[{"text":"Apple Vision Pro User Guide","type":"text"}],"type":"link","url":"https:\/\/support.apple.com\/guide\/apple-vision-pro"},"human-interface-guidelines-page-image-card.png":{"alt":"An illustration of several Liquid Glass components such as toggles, sliders, and buttons, atop a neutral background. The transparent components cast shadows on the background and allow their colored elements, like a blue slider track and a green toggle backing, to show through, highlighting the Liquid Glass material's lensing effect.","identifier":"human-interface-guidelines-page-image-card.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/human-interface-guidelines-page-image-card@2x.png"}]},"immersive-experiences.svg":{"alt":"An icon that suggests Apple Vision Pro.","identifier":"immersive-experiences.svg","type":"image","variants":[{"svgID":"Design-Spec","traits":["1x","light"],"url":"\/images\/com.apple.HIG\/immersive-experiences.svg"}]},"inputs-digital-crown-thumbnail.png":{"alt":"A sketch of a curved arrow beside a Digital Crown, that suggests turning the Digital Crown. The image is tinted purple to subtly reflect the purple in the original six-color Apple logo.","identifier":"inputs-digital-crown-thumbnail.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/inputs-digital-crown-thumbnail@2x.png"},{"traits":["2x","dark"],"url":"\/images\/com.apple.HIG\/inputs-digital-crown-thumbnail~dark@2x.png"}]},"inputs-eyes-thumbnail.png":{"alt":"A sketch of a human eye. The image is tinted purple to subtly reflect the purple in the original six-color Apple logo.","identifier":"inputs-eyes-thumbnail.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/inputs-eyes-thumbnail@2x.png"},{"traits":["2x","dark"],"url":"\/images\/com.apple.HIG\/inputs-eyes-thumbnail~dark@2x.png"}]},"overview.svg":{"alt":"An icon of a grid comprised of four squares.","identifier":"overview.svg","type":"image","variants":[{"svgID":"overview","traits":["1x","light"],"url":"\/images\/com.apple.HIG\/overview.svg"}]},"platforms-designing-for-visionos-thumbnail.png":{"alt":"A stylized representation of Apple Vision Pro. The image is tinted green to subtly reflect the green in the original six-color Apple logo.","identifier":"platforms-designing-for-visionos-thumbnail.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/platforms-designing-for-visionos-thumbnail@2x.png"},{"traits":["2x","dark"],"url":"\/images\/com.apple.HIG\/platforms-designing-for-visionos-thumbnail~dark@2x.png"}]},"platforms-visionOS-intro.png":{"alt":"A stylized representation of Apple Vision Pro shown on top of a grid. The image is overlaid with rectangular and circular grid lines and is tinted green to subtly reflect the green in the original six-color Apple logo.","identifier":"platforms-visionOS-intro.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/platforms-visionOS-intro@2x.png"},{"traits":["2x","dark"],"url":"\/images\/com.apple.HIG\/platforms-visionOS-intro~dark@2x.png"}]},"platforms.png":{"alt":"","identifier":"platforms.png","type":"image","variants":[{"traits":["2x","light"],"url":"\/images\/com.apple.HIG\/platforms@2x.png"},{"traits":["2x","dark"],"url":"\/images\/com.apple.HIG\/platforms~dark@2x.png"}]},"visionos.svg":{"alt":"An icon that depicts the outline of Apple Vision Pro.","identifier":"visionos.svg","type":"image","variants":[{"svgID":"Design-Spec","traits":["1x","light"],"url":"\/images\/com.apple.HIG\/visionos.svg"}]}}}