Spatial Design (visionOS)

The design rules that make a visionOS app comfortable instead of exhausting — distilled from Apple's spatial-design sessions (WWDC23–26). Widget-specific rules live in visionos/widgets; custom immersive-environment production and budgets live in immersive-environments.md.

When This Skill Activates

• Designing or reviewing a visionOS app, window, volume, or immersive space
• "Users say it's tiring / uncomfortable / hard to hit controls"
• Porting an iPad app and deciding what should become spatial
• Adding hover effects, custom gestures, environments, or spatial audio
• Choosing a video experience format (spatial, 180°, 360°, wide-FOV, Apple Immersive)

The prime directive: find the key moment

Don't window a 2D app. Identify the one thing only possible on visionOS — the "key moment" — and build around it. Immersion has three approaches, and full immersion is not mandatory: full environments · integration with real surroundings (scene sensing) · meaningful audio.