Overview

Spatio provides a powerful platform development system that lets you build custom React applications running inside the Spatio shell. These platforms integrate seamlessly with workspace context, user data, and shell UI controls.

Core Components

Platform SDK: React hooks for accessing context and shell features
Platform Loader: Dynamic bundle loading system
Compiler Worker: Cloudflare-based build and deployment
R2 Storage: Global CDN for bundle distribution

Key Features

React-Based: Build platforms with familiar React patterns
Context Sharing: Access user, workspace, and organization data
Shell Integration: Control sidebars, fullscreen, and navigation
Event Communication: Inter-platform messaging via event bus
Persistent Storage: Platform-scoped key-value storage

Architecture

Platforms run inside the Spatio shell:

Spatio Shell
├── PlatformLoader     # Dynamic bundle loading
├── PlatformProvider   # Context injection
└── Your Platform      # React application
    ├── usePlatformContext
    ├── useShellState
    ├── useNavigation
    └── useSpatioAPI

Use Cases

Custom Dashboards: Analytics, monitoring, reporting
Internal Tools: CRM, inventory, project management
Integrations: Third-party service interfaces
Specialized Workflows: Industry-specific applications

Getting Started

Create a React project with @spatio/platform-sdk
Build as IIFE bundle with externalized dependencies
Deploy via the Compiler Worker API
Register your platform in the workspace