Meta Spatial SDK enables Android developers to create mixed reality experiences that blend digital content with the physical world. Spatial apps place objects, panels, and interactive elements anywhere in your environment. Traditional mobile apps stay confined to flat screens.
Spatial SDK introduces spatial anchoring, 3D scene management, and cross-device input handling. These capabilities need different mental models than traditional Android development. This guide navigates the transition and builds foundational knowledge for spatial app development.
Quick start crash course
To get started quickly, try the first app crash course. The crash course gives you a tour of Spatial SDK features and tooling, and gives you a basic working app to experiment with. You can start with an existing Android app or start from scratch.
Template project walkthrough
This path provides you with a foundation for building your own spatial apps.
Project directory structure with scenes/, assets/, and source organization
Modular package system for lightweight, focused spatial apps
Dual-activity architecture separating the 3D environment from UI logic
Spatial Editor workflow with asset pipeline automation
ECS implementation with runtime component modification examples
Dynamic scene loading and composition management
Recommended learning path
This isn’t an exhaustive list of all the features and capabilities of Spatial SDK. Instead, it’s a recommended learning path if you’re new to building spatial apps. Progress through the sections in order, and use the samples and showcases to explore more advanced features. Explore the other pages in the documentation for more detailed information, and use the API references to learn about specific classes and methods.
Key concepts
Spatial apps are organized differently than traditional Android apps. Understanding the Entity-Component-System pattern prevents expensive architectural mistakes.
Spatial SDK architecture: Learn how Spatial SDK works with Android apps and how your app can access Quest headset features.
Physics: Make objects fall, bounce, and crash into each other just like real objects.
Spatial audio: Make sounds come from specific locations in 3D space, getting louder when you get closer.
Mixed Reality Utility Kit: Scan the user’s room and place virtual objects on their real furniture and walls.
Passthrough camera API: Use the headset’s cameras to see the real world and add digital content on top of it.
GitHub samples
The Meta Spatial SDK Samples repository contains 11 sample applications demonstrating specific Spatial SDK features. Each sample focuses on a particular capability with complete source code, build scripts, and documentation.
Sample applications include:
AnimationsSample: Animation clips, reusable drivers, and procedural animation techniques
StarterSample: Foundation project for getting started tutorials
These samples provide focused learning experiences for individual SDK features. Use them to understand API patterns, study implementation approaches, and experiment with specific capabilities before building your own applications.
Showcases
The Showcases directory contains five fully-featured applications available on the Meta store. These production-quality apps demonstrate complete Spatial SDK implementations and serve as architectural references for building commercial applications.
Featured showcase applications:
Focus (Meta store, GitHub): Productivity workspace with panel management, spatial object persistence, AI integration, and mixed reality task organization
Media View (Meta store, GitHub): Mixed reality media viewer supporting 2D/360-degree content, spatial media, and cloud storage integration
Geo Voyage (Meta store, GitHub): Educational exploration platform with interactive globe, AI companion, voice recognition, and geographic content integration
Meta Horizon UI Set (GitHub): Design system components and interaction patterns for spatial interfaces
Spatial Scanner (GitHub): Room scanning and spatial mapping demonstration application
Each showcase includes comprehensive documentation covering project structure, technical implementation details, and development best practices. Use showcases to understand full application architecture, study production-level code organization, and learn advanced feature integration patterns.