Build your first Spatial SDK app

Updated: Sep 30, 2025

This tutorial is an interactive walkthrough of the workflow you’ll use when creating or converting an app with Meta’s Spatial Editor and Spatial SDK. If you’re new to Android development and choose to do both the required and optional sections, you’ll probably need at least an hour to complete this tutorial.

This tutorial will teach you how to:

Set up a new Spatial SDK app, or add Spatial SDK to an existing 2D Android app.

Import 3D assets.

Manipulate 3D assets both programmatically and through Spatial Editor.

Create and use custom components.

Embed 2D content into a 3D VR environment as an interactable panel.

Preview your app’s VR environment.

To learn about best practices that will further enhance your app’s user experience and broaden its audience, see the design guidelines.

Before you begin

To start development, you’ll need:

Install Android Studio so you can develop and launch Android applications.

Install Spatial SDK’s Android Studio Plugin.

Install Meta Spatial Editor for either Windows or Mac, which already includes the CLI needed to export projects.

Install Meta Quest Developer Hub.

A Meta Quest device (Quest 2, Quest Pro, or Quest 3) for testing.

Enable developer mode on your Meta Quest device

On your mobile device, open the Meta Horizon app.

In the app, tap the hamburger menu (the icon with three horizontal lines) next to the search bar. Then, tap Devices and select your headset from the results.

Video: Shows selection of the Devices item in the hamburger menu.

Tap Headset Settings beneath the image of your headset.

Tap Developer Mode.

Turn on the Developer Mode toggle switch.

Toggle Developer Mode to the on position

Use a USB-C cable to connect the headset to your computer.

Put on the headset.

In the headset, go to Settings > Advanced > Developer, and then enable Enable custom settings and MTP Notification.

When asked to allow USB debugging, select Always allow from this computer.

Important

Developer Mode is intended for development tasks such as running, debugging and testing applications. Engaging in other activities may result in account limitations, suspension, or termination. For more information, see Content Guidelines.