Overview
SpaceOS is ZenSpace's multi-tenant platform for managing physical spaces — meeting rooms, offices, and coworking areas — with bookings, payments, IoT device automation, and meeting room displays.
What SpaceOS Does
SpaceOS provides a complete solution for space management:
- Booking management — Create, modify, and cancel reservations with real-time availability
- Payment processing — Integrated pricing, Stripe payments, vouchers, and refunds
- IoT device automation — Smart locks, Wi-Fi hotspots, fans, and lights controlled automatically based on bookings
- Meeting room displays — Dedicated hardware and web apps showing real-time room status
- Multi-tenant architecture — Organizations manage their own spaces, users, and settings independently
- Third-party integrations — Google Calendar, Outlook, iCal sync, and custom adapters
Platform Architecture
SpaceOS is composed of 8 services:
The 8 Services
| Service | Repository | Stack | Responsibility |
|---|---|---|---|
| ZenCore | zs-backend | NestJS + PostgreSQL | Main API: auth, orgs, bookings, spaces, payments, webhooks |
| ZenEdge | zs-mrd-backend | NestJS + TypeORM | Device/edge bridge: displays, IoT gateways, physical spaces, magic links |
| Scheduler | zs-bullmq | BullMQ + Redis | Meeting-space state machine, delayed jobs, webhook delivery |
| Realtime | zs-realtime-service | Socket.IO | WebSocket relay for live updates |
| IoT Adapter | zs-iot | Express + SQLite | On-premise gateway on Raspberry Pi |
| Admin Dashboard | zs-admin | Next.js | Admin console + public booking |
| Booking SPA | zs-booking | React + Vite | Standalone public booking flow |
| Meeting Room Display | zs-meeting-room-display | React + Vite + Socket.IO | Room status display app |
Who Is This For?
SpaceOS documentation serves four audiences:
| Audience | Goal | Start here |
|---|---|---|
| Operator / Admin | Configure and run a SpaceOS instance | For Operators |
| Developer | Integrate with ZenCore APIs or embed booking | For Developers |
| Adapter Partner | Build a certified IoT adapter | For Adapter Partners |
| Installer / IT | Deploy the on-prem IoT Adapter | For Installers |
Next Steps
- Quickstart — Make your first API call in 5 minutes
- Key Concepts — Understand the core data model
- Platform Architecture — Deep dive into how services interact