# visionOS Spatial Design (visionOS 空間デザイン)

> The screen language Apple set out for Vision Pro in its Human Interface Guidelines. A window is an upright plane whose background is a material Apple calls glass, so the room shows through it while specular reflections and shadows report where the plane sits and how big it is. visionOS defines a point as an angle rather than a count of pixels, which keeps a window's apparent size constant as it moves away.

- IndexStyle No.512 — https://indexstyle.org/styles/visionos-spatial
- Kind: Style · Family: Apple UI · Era: 2023–
- Mood: Futurism, Calm, Technology
- Color cues: #FFFFFF / #C9CED6 / #101014 (cues taken from reference works, not a fixed palette)

## Defining characteristics

- An upright plane with a glass background that cannot be swapped out, carrying specular reflections and shadows
- A default window of 1280x720 pt, opening about two metres away with an apparent width near three metres
- A hover effect that lights only the element being looked at, with one rounded target region per control
- Volumes have no visible frame, and their close button and window bar rotate to face whoever walks around them

## Best used for

- Reworking an iPad layout into a panel that stays legible while floating over a real room
- Showing a product model at life size, placed in the room as a frameless volume rather than a window

## Composition recipe

- Typography & lettering: Use SF Pro, choosing the heavier body and title steps this platform provides. Default to white text and keep the glyphs themselves flat. Labels tied to a point in space should always turn to face the viewer.
- Layout & structure: Start from 1280x720 pt and let the content decide the proportion. Leave at least 16 pt of margin around each interactive item and keep centres at least 60 pt apart. Always set a minimum and a maximum window size.
- Material & texture: Keep the glass background. Build depth from shadow, specular reflection and colour temperature, never from raised text. Keep any 3D inside a window shallow and move deeper objects into a volume.

## What to avoid

Replacing the glass with an opaque fill breaks the visual relationship between elements, hurts legibility, and makes the window feel heavy because it hides the room behind it.

## Application checklist

Before calling a piece an application of this style, check it against the defining characteristics:

- [ ] An upright plane with a glass background that cannot be swapped out, carrying specular reflections and shadows
- [ ] A default window of 1280x720 pt, opening about two metres away with an apparent width near three metres
- [ ] A hover effect that lights only the element being looked at, with one rounded target region per control
- [ ] Volumes have no visible frame, and their close button and window bar rotate to face whoever walks around them
- [ ] At least one reference work below has been studied directly
- [ ] The caution above ("What to avoid") has been addressed

## Related styles

- **Liquid Glass (リキッドガラス)** — Unifies the floating control and navigation layer as a fluid glass material that refracts and adapts to the content beneath. → https://indexstyle.org/styles/liquid-glass
- **Glassmorphism (グラスモーフィズム)** — Shows depth and hierarchy through translucent layers, floating information lightly. → https://indexstyle.org/styles/glassmorphism

## Further study

- HIG の windows と spatial layout を読み、点を角度で定義することが版面設計に何をもたらすか確かめる
- 画像と説明文をひとつの操作対象にまとめるとき、ホバー効果を当てる領域をどう定義しているか
- 1280x720 pt の窓を2メートル先に置いたときの実際の見かけの大きさを測る

## Reference works

- visionOS 26 のホーム画面 2025 — Wikimedia Commons / CC0 — https://commons.wikimedia.org/wiki/File:Apple%20Vision%20Pro%20home%20screen%20-%20visionOS%2026.png
- visionOS 2 でアプリの窓を実景に重ねた画面 2025 — Wikimedia Commons / CC0 — https://commons.wikimedia.org/wiki/File:Heypster%20visionOS%202.jpg
- visionOS 26 のコントロールセンター 2025 — Wikimedia Commons / CC0 — https://commons.wikimedia.org/wiki/File:Centre%20de%20contr%C3%B4le%20-%20visionOS%2026.png

## Source of record

- Apple — Human Interface Guidelines: Designing for visionOS — https://developer.apple.com/design/human-interface-guidelines/designing-for-visionos

## Machine surfaces

- JSON: https://indexstyle.org/api/styles/visionos-spatial
- Image-generation prompt (legally clean): https://indexstyle.org/styles/visionos-spatial/prompt.txt
- MCP: https://indexstyle.org/mcp (tools: search_styles, get_style, compose_styles; prompts: image-prompt, apply-style)