How clockworklabs/spacetimedb works
SpacetimeDB combines a relational database with an application runtime: developers define and upload modules, and clients connect directly to invoke logic and receive live table changes. The graph preserves the documented module lifecycle, transactional data path, subscriptions, durable storage, and client SDK surface. Source excerpts are limited, so internal links are shown only where the README or indexed source references support them; unsampled subsystem connections are omitted.
Main entry points: module_subscription_manager.rs Subscription manager · server Application module · db_connection_impl.ts TypeScript SDK · module_host.rs Module host
Components 18
Module authoring and runtime
- Application module
crates/bindings-typescript/src/server - Module compilation
crates/bindings-macro/src/lib.rs - Module host
crates/core/src/host/module_host.rs - Transaction execution
crates/execution/src/pipelined.rs - SpacetimeDB CLI
crates/cli/src/main.rs
Database and synchronization
- Relational database
crates/dst/src/engine.rs - Durable storage
crates/core/src/host/disk_storage.rs - Subscription manager
crates/core/src/subscription/module_subscription_manager.rs - Client connections
crates/core/src/client/client_connection.rs - Client messages
crates/core/src/client/messages.rs
Client SDKs
- TypeScript SDK
crates/bindings-typescript/src/sdk/db_connection_impl.ts - Schema and query types
crates/bindings-typescript/src/lib/schema.ts - Client data cache
crates/bindings-typescript/src/sdk/client_cache.ts - C++ bindings
crates/bindings-cpp/include/spacetimedb/table.h - C# runtime bindings
crates/bindings-csharp/Runtime/AuthCtx.cs
Identity and access
- Rust identity and tokens
crates/auth/src/identity.rs
Other components
- Module developer
- Connected application client
Connections 19
- Module developer → Application module: defines
README.md - Application module → Module compilation: compiles
README.md - Module compilation → Module host: runs module
README.md - Connected application client → Client connections: connects directly
README.md - Connected application client → Module host: calls reducers
README.md - Connected application client → Subscription manager: subscribes tables
README.md - Subscription manager → Client messages: references messages
crates/core/src/subscription/module_subscription_manager.rs - Subscription manager → Client connections: references clients
crates/core/src/subscription/module_subscription_manager.rs - Subscription manager → Module host: references host
crates/core/src/subscription/module_subscription_manager.rs - Relational database → Durable storage: persists durably
- Relational database → Subscription manager: provides committed changes
README.md - Subscription manager → Connected application client: pushes updates
README.md - Connected application client → TypeScript SDK: uses
README.md - Connected application client → C++ bindings: uses
README.md - Connected application client → C# runtime bindings: uses
README.md - TypeScript SDK → Client data cache: maintains cache
crates/bindings-typescript/src/sdk/db_connection_impl.ts - TypeScript SDK → Schema and query types: uses schema
crates/bindings-typescript/src/sdk/db_connection_impl.ts - Module developer → SpacetimeDB CLI: operates
README.md - Application module → Rust identity and tokens: defines authorization
README.md