visionos-design-guidelines

Guide visionOS app design for spatial UX, windows, and immersion.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/helmordev/litera-quest --skill visionos-design-guidelines-helmordev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: visionos-design-guidelines
Source: https://github.com/helmordev/litera-quest/tree/main/.github/skills/visionos-design-guidelines
Command: npx skills add https://github.com/helmordev/litera-quest --skill visionos-design-guidelines-helmordev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Apple Human Interface Guidelines provide a comprehensive framework to design spatial computing experiences for Vision Pro, ensuring user comfort, accessibility, and consistency across apps.

Core Features & Use Cases

  • Spatial Layout, Eye & Hand Input, Windows, Volumes, Immersive Spaces, Materials & Depth, and Ornaments guidance to shape safe and intuitive interfaces.
  • Use of glass materials, depth cues, vibrancy for readability, and ornaments positioning to maintain a clean content area.
  • Real-world use: building apps that float windows in space, support progressive immersion, and provide clear exit paths.

Quick Start

Apply these guidelines to a visionOS app to ensure safe immersion, comfortable interaction, and consistent spatial UI.

Frequently Asked Questions about visionos-design-guidelines

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design spatial UI layouts for visionOS apps?

To design spatial UI layouts for visionOS apps, position windows and volumes considering depth, eye input, and hand interactions to maintain user comfort and accessibility. Apply glass materials and standard window chrome to ensure content readability within the spatial environment.

When should I use immersive spaces instead of windows in visionOS?

Use immersive spaces in visionOS when you need to transition users into a fully integrated environment, rather than using standard windows or volumes. Provide progressive immersion and clear exit paths to ensure users can safely navigate back from the spatial experience.

How do I position leading and bottom ornaments in visionOS spatial interfaces?

Position leading and bottom ornaments in visionOS spatial interfaces to maintain a clean content area while keeping controls accessible. Ensure ornaments use glass materials and vibrancy for readability, and avoid obstructing the primary window layout during eye and hand input.

What are the readability requirements for glass materials in visionOS design?

Readability requirements for glass materials in visionOS design dictate using vibrancy and depth cues to differentiate interface layers. Apply standard window chrome and ensure content remains legible against real-world backgrounds by leveraging the system's built-in material behaviors.

Can I arrange multiple windows in an arc layout for visionOS spatial apps?

Yes, you can arrange multiple windows in an arc layout for visionOS spatial apps to optimize the user's field of view. Ensure the arc window arrangement maintains comfortable eye and hand input ergonomics, and apply standard window chrome for consistent spatial UI management.

Does RealityKit support progressive immersion transitions in visionOS apps?

RealityKit supports progressive immersion transitions in visionOS apps by managing the shift between standard windows, volumes, and immersive spaces. Ensure your spatial UI provides clear exit paths and maintains user comfort throughout the immersion transition process.