spatial-gestures

Implement spatial gesture patterns for visionOS with code examples.

32|10|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/moasq/nanowave --skill spatial-gestures
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spatial-gestures
Source: https://github.com/moasq/nanowave/tree/main/internal/orchestration/skills/visionos/spatial-gestures
Command: npx skills add https://github.com/moasq/nanowave --skill spatial-gestures

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers implement and understand the various spatial gesture inputs available in visionOS, making it easier to create interactive and intuitive applications for the platform.

Core Features & Use Cases

  • Gesture Implementation: Provides code examples for tap, drag, and long-press gestures on 3D entities.
  • Indirect Gestures: Demonstrates how standard SwiftUI gestures work with eye tracking on 2D windows.
  • Rules & Best Practices: Outlines essential guidelines for effective spatial interaction design in visionOS.
  • Use Case: When building a visionOS app that allows users to manipulate 3D objects in a virtual space, this Skill can be used to quickly implement pinch-to-zoom, drag-to-move, and tap-to-select functionalities.

Quick Start

Implement a tap gesture on a 3D entity using the provided Swift code snippet.

Frequently Asked Questions about spatial-gestures

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

FAQPage Schema
How do I implement spatial gestures for 3D objects in visionOS?

To implement spatial gestures in visionOS, you apply SwiftUI gesture patterns to 3D entities for eye tracking, hand pinch, drag, rotate, and magnify inputs. This enables tap-to-select, pinch-to-zoom, and drag-to-move interactions within your app.

Do standard SwiftUI gestures work with eye tracking on visionOS 2D windows?

Standard SwiftUI gestures work as indirect gestures with eye tracking on visionOS 2D windows. Users look at a target to focus it and perform a secondary action like a pinch to trigger the interaction.

What are the design rules for spatial interaction and hover effects in visionOS?

Spatial interaction design in visionOS enforces specific rules for interactive target size and hover effects. Adhering to these guidelines ensures your spatial gestures are accessible and provide an optimal user experience.

Can I use pinch and drag gestures to manipulate 3D entities in a visionOS app?

You can use pinch and drag gestures to manipulate 3D entities in a visionOS app. The provided code examples demonstrate attaching these spatial gestures to objects for moving, rotating, and scaling them in a virtual space.

What is the best way to handle tap and long-press gestures on 3D entities in visionOS?

The best way to handle tap and long-press gestures on 3D entities in visionOS is by using the provided SwiftUI code snippets. These examples outline how to attach direct spatial input handlers to your virtual objects.

Are there specific target size requirements for visionOS spatial gesture interactions?

Yes, visionOS spatial interactions enforce specific rules for interactive target size. Following these guidelines ensures that 3D entities and 2D windows are easily selectable by eye tracking and hand pinch gestures.