A macOS document-based application that reverse-engineers Reality Composer Pro functionality including support for editing .realitycomposerpro native files.

Reality Composer Pro (RCP) is Apple's professional tool for creating 3D content and spatial experiences for visionOS and iOS. While powerful, its file format and package structure aren't officially documented. Deconstructed aims to:

1. Open .realitycomposerpro package files
2. Parse and display the project structure
3. Edit scenes (USDA) and assets through a similar native macOS interface
4. Save changes back to the package format

• swift-composable-architecture - App architecture and reducer composition
• USDInterop - Public OpenUSD package family (USDInterfaces, USDInterop, USDInteropCxx, USDOperations)
• StageView - RealityKit-backed viewport component

Use:

• Xcode 26.3 or newer
• Deconstructed.xcworkspace

Notes:

• the committed manifests use remote package URLs for CI and fresh clones
• local first-party package overrides are optional and should be configured in the workspace, not by editing committed manifests
• package macros may require local approval in Xcode the first time you build on a machine

Further reading:

• Local Development (CI-Safe)
• USDOperations Refactor Evaluation

Deconstructed/
├── Deconstructed/                  # Main app target
│   ├── DeconstructedApp.swift      # App entry point
│   ├── Info.plist                  # Document type declarations
│   └── Assets.xcassets/
├── Packages/
│   └── DeconstructedLibrary/       # Swift Package with feature modules
│       ├── Sources/
│       │   ├── RCPDocument/        # FileDocument conformance
│       │   ├── RCPPackage/         # Package model + IO helpers
│       │   ├── DeconstructedModels/ # Shared app/document models
│       │   ├── DeconstructedClients/ # Cross-feature clients
│       │   ├── DeconstructedFeatures/ # Root reducers and orchestration
│       │   ├── DeconstructedUI/    # Shared/editor shell UI
│       │   ├── ProjectBrowser*     # Browser models, clients, feature, UI
│       │   ├── SceneGraph*         # Scene graph models, clients, feature, UI
│       │   ├── Inspector*          # Inspector models, feature, UI
│       │   ├── ViewportModels/     # Viewport state models
│       │   ├── ViewportUI/         # 3D viewport (RealityKitStageView-based)
│       │   ├── DeconstructedUSDInterop/   # USD bridge surfaces and app-local USD authoring
│       │   └── ProjectScaffolding/ # New project template/scaffolding
│       └── Tests/
├── Deconstructed.xcodeproj/
└── Deconstructed.xcworkspace/      # Primary local entry point

The .realitycomposerpro document is a bundle (package) with this structure:

Package.realitycomposerpro/          # The document bundle
├── ProjectData/
│   └── main.json                    # UUID mappings for scenes
├── WorkspaceData/
│   ├── Settings.rcprojectdata       # Editor settings
│   ├── SceneMetadataList.json       # Hierarchy state
│   └── <user>.rcuserdata            # Per-user preferences
├── Library/                         # Asset library
└── PluginData/                      # Plugin-specific data

Sources/                             # Assets (sibling to document)
└── <ProjectName>/
    ├── <ProjectName>.swift          # Bundle accessor
    └── <ProjectName>.rkassets/      # Asset directory
        └── Scene.usda               # USD scene files

The .realitycomposerpro bundle is the document itself, while the parent folder containing Sources/ is the SPM package wrapper for Xcode integration. RCP treats main.json as a loose index - the filesystem is the source of truth for what exists.

This project is documented in a series of articles exploring the reverse-engineering process:

1. Deconstructing Reality Composer Pro: Introduction

   • Overview of the project goals and motivations
   • Initial exploration of the .realitycomposerpro format

2. Deconstructing Reality Composer Pro: Document Type

   • Deep dive into the package structure
   • Understanding main.json and UUID mappings
   • Document-based app architecture with FileWrapper

3. Deconstructing Reality Composer Pro: Project Browser

   • Building the file browser with TCA
   • File watching with FSEvents
   • Asset discovery and tree management

4. Deconstructing Reality Composer Pro: Viewport

   • Integrating StageView/RealityKit for 3D rendering
   • Viewport toolbar and camera controls
   • Environment configuration

5. Deconstructing Reality Composer Pro: Scene Navigator

   • Scene hierarchy visualization
   • USD prim navigation
   • Inserting primitives and structural elements

6. Deconstructing Reality Composer Pro: Inspector Basics

   • Building the Inspector panel with TCA and scoped feature state
   • Wiring USD stage metadata (default prim, scale, up axis) into the UI
   • Establishing the selection-driven path toward prim-level inspection

7. Deconstructing Reality Composer Pro: Inspector Bindings, References, Variants

   • Extending prim inspection with material bindings and relationship references
   • Implementing variant set discovery and selection workflows
   • Bridging inspector edits to live viewport and scene graph updates

8. Deconstructing Reality Composer Pro: Inspector Components

   • Adding component-level inspection and editing workflows
   • Modeling component data/state in TCA-friendly feature boundaries
   • Keeping inspector interactions synchronized with stage updates

9. Deconstructing Reality Composer Pro: Inspector Components Continued

   • Continuing the RealityKit component authoring work
   • Expanding inspector coverage for more component surfaces
   • Refining component editing behavior and data modeling

• MaterialX Interchange - MaterialX vs UsdPreviewSurface portability through RealityKit/RCP

• ✅ Document Handling: Open and save .realitycomposerpro packages
• ✅ Project Browser: File tree with folder creation, file operations, and live watching
• ✅ Scene Navigator: Hierarchy view with prim selection and insertion
• ✅ Viewport: 3D preview with grid, axes, and environment controls
• ✅ Inspector: Layer Data, scene playback, transform editing, material bindings, references, variants, and component workflows

• 🚧 Material Editor: Shader graph integration
• 🚧 Particles / VFX Emitter: Inspector coverage, authoring workflows, and fixture-driven validation

Apache-2.0. See LICENSE.

• Apple's Reality Composer Pro team (for the inspiration)
• The Composable Architecture by Point-Free (for making regressions rare)