visionos-design-guidelines

Provide visionOS design guidance for Apple Vision Pro applications.

61|3|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/joelhooks/joelclaw --skill visionos-design-guidelines-joelhooks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: visionos-design-guidelines
Source: https://github.com/joelhooks/joelclaw/tree/main/.agents/skills/visionos-design-guidelines
Command: npx skills add https://github.com/joelhooks/joelclaw --skill visionos-design-guidelines-joelhooks

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides comprehensive design rules and best practices for developing applications on Apple Vision Pro, ensuring user comfort, intuitiveness, and platform consistency.

Core Features & Use Cases

  • Spatial Layout Guidance: Rules for positioning windows and content in the user's physical space.
  • Input Interaction Design: Best practices for eye and hand input, including target sizes and feedback.
  • Window, Volume, and Immersive Space Design: Guidelines for structuring different types of spatial experiences.
  • Material and Ornament Usage: Recommendations for visual appearance and UI element placement.
  • Use Case: A developer building a new app for Apple Vision Pro can use this skill to ensure their UI adheres to all critical design principles, preventing common pitfalls like head-locked UI or inaccessible targets.

Quick Start

Review the spatial layout rules for designing a new visionOS application.

Frequently Asked Questions about visionos-design-guidelines

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

FAQPage Schema
What are the Apple Vision Pro human interface guidelines for spatial layout?

visionOS design guidelines specify positioning windows and content within the user's physical space to ensure comfort and platform consistency. Adhering to these spatial layout rules prevents common pitfalls like head-locked UI.

How do I design eye and hand input interactions for visionOS applications?

To design eye and hand input for visionOS applications, follow best practices for target sizes and feedback. These interaction design guidelines ensure user input remains intuitive, accessible, and comfortable within the spatial computing environment.

When should I use windows, volumes, or immersive spaces in Apple Vision Pro?

Use windows, volumes, and immersive spaces in Apple Vision Pro to structure different types of spatial experiences. The guidelines define when to use each paradigm to maximize user comfort and platform consistency.

What are the best practices for using materials and ornaments in visionOS?

Best practices for using materials and ornaments in visionOS involve following specific recommendations for visual appearance and UI element placement. Proper material and ornament usage ensures your spatial application adheres to platform conventions.

Why does my Apple Vision Pro UI cause user discomfort or motion sickness?

Apple Vision Pro UI causes user discomfort when it violates platform conventions for comfort, such as using head-locked UI or improperly structured immersive spaces. Following spatial layout and input guidelines prevents these issues.