Spec — XR developer preview

Facet Develop of Koder Design. Material parity: https://m3.material.io/develop/extended-reality.

Status: preview (not yet shipping; evolves with platforms).

URL: https://kds.koder.dev/{locale}/develop/xr/.

Scope of "preview"

This spec reserves the surface and contract for XR adaptations without committing to ship in v1. It's a forward declaration so:

• Token taxonomy already considers XR before stabilizing
• Component specs avoid 2D-only assumptions that break XR adaptation
• Implementer can experiment knowing the contract will be respected

R1 — Target platforms

Tier 1: full spec coverage at v1. Tier 2: feature-parity within 6 months of v1. Tier 3: opt-in, may diverge.

R2 — Layout primitives

R3 — Visual tokens — XR additions

XR adds tokens NOT present in 2D specs:

Per themes/elevation.kmd § R5, elevation in XR becomes a literal z-axis offset; tokens map 1 dp ≈ 0.5 cm in XR space.

R4 — Component adaptations

Each canonical component must define its XR rendering OR explicitly mark as not-yet-supported:

Components NOT yet adapted (Tier 1 missing): carousels (XR equivalent unclear — defer), sliders (need hand-grip implementation), pickers (volumetric date picker — research project).

R5 — Input model

Tier 1 (Vision Pro) requires eye + pinch + voice. Tier 2 (Quest) adds controller fallback.

R6 — Accessibility in XR

• VoiceOver / TalkBack analogues work in XR (audio-described navigation)
• Hand-reach interactions have fallback via gaze + pinch for users with limited mobility
• Reduce Motion in XR = fewer floating animations + reduced positional reanchoring
• Color contrast applies in XR (background = scene, not just surface — UI contrast checker accounts for scene brightness)

R7 — Performance budgets

XR is unforgiving of dropped frames — under-budget hardware should gracefully reduce visual complexity (lower elevation, simpler shadows) not the frame rate.

R8 — Forbidden patterns

• ❌ 2D modal that completely blocks XR scene (immersive mode handles modals via floating windows; full-screen takeover breaks immersion)
• ❌ Animations that move > 30°/s in user's gaze area (motion sickness)
• ❌ Pinned UI in the center of view (forces user to look away)
• ❌ Tiny hit targets (< 4 cm in world space)
• ❌ Sound effects with no spatial audio anchor in XR contexts
• ❌ XR-specific tokens that don't degrade gracefully in 2D (must define 2D fallback per token)

R9 — Versioning

XR preview tracks its own minor version inside Koder Design semver:

• koder-design v1.5.0 may include xr-preview v0.3 (still preview)
• XR exits preview when at least 1 Tier 1 platform ships a real Koder app and the contract is owner-ratified

R10 — Status badge

The catalog page MUST show:

┌─────────────────────────────────────────────┐
│   🚧 PREVIEW                                 │
│   This spec is forward-looking. Components,  │
│   tokens, and interactions may change before │
│   the first stable release of Koder Design   │
│   XR. Experiment freely; do not depend on    │
│   the API as stable yet.                     │
└─────────────────────────────────────────────┘

Cross-link

• themes/elevation.kmd — z-axis mapping
• app-layout/safe-area.kmd — analogous to XR volume boundaries
• voice/wake-word.kmd — voice as primary XR input
• components/*.kmd — per-component XR adaptation notes

Implementation tracking

• engines/sdk/koder-design-xr/ — placeholder (preview status)
• Linked Material doc: https://m3.material.io/develop/extended-reality
• Owner-curated; not auto-generated. Updated per Tier 1 platform release.