danmossa Entry point for the SpacetimeDB skill collection. SpacetimeDB combines a database, server-side application logic, and realtime client sync into one programmable backend.
How to use this skill
- Find the specialized skill in the router below that best matches the task.
- Load that skill's
SKILL.mdand follow its guidance. - Open only the referenced Markdown files that match the current subtask.
- If no sub-skill fits, search copied references in the most likely skill before falling back to external docs.
Do not load every SpacetimeDB reference file by default. Start with the focused skill body, then load a reference only when the body says the details are needed or the task requires exact API syntax.
Core model
- A database is a published instance of a module; the module defines tables, reducers, procedures, views, and public client surface.
- Tables store state. Public tables can be subscribed to by clients; private tables are server-only unless exposed through views or reducers.
- Reducers are transactional entrypoints for state changes. Failed reducers roll back their table mutations.
- Procedures can return values and perform external work such as HTTP requests; open transactions explicitly when they need database writes.
- Views expose derived, read-only data. Prefer anonymous views when the result does not depend on the caller.
- Clients use generated bindings, connect with
DbConnection, subscribe to rows, read the local cache, and invoke reducers or procedures.
For longer descriptions and trigger keywords for every skill, see references/index.md.
Skill router
Foundations
| Skill | Load when... |
|---|---|
| spacetimedb-quickstarts | Installing SpacetimeDB, understanding the architecture, starting a new app, or choosing a framework quickstart. |
| spacetimedb-cli | Running spacetime commands: init, build, publish, generate, call, sql, logs, dev, server configuration, or standalone config. |
| spacetimedb-databases | Creating, developing, publishing, migrating, or operating SpacetimeDB database modules. |
| spacetimedb-upgrade | Migrating projects from SpacetimeDB 1.0 to 2.0 or fixing code affected by those breaking changes. |
Module Schema And Logic
| Skill | Load when... |
|---|---|
| spacetimedb-tables | Defining tables, columns, indexes, constraints, primary keys, event tables, schedule tables, access permissions, or table performance. |
| spacetimedb-reducers | Writing reducers, lifecycle reducers, reducer context code, scheduled reducers, table mutations, or reducer error handling. |
| spacetimedb-procedures | Writing procedures, calling reducers from procedures, making HTTP requests, or returning procedure values. |
| spacetimedb-views | Defining views, view arguments, SQL-backed projections, and client-facing derived data. |
| spacetimedb-auth | Authentication, SpacetimeAuth, Auth0, Clerk, auth claims, authorization, row-level security, or rejecting client connections. |
Clients
| Skill | Load when... |
|---|---|
| spacetimedb-clients | General client SDK concepts: codegen, connection lifecycle, local cache, subscriptions, reducer invocation, and update semantics. |
| spacetimedb-client-typescript | TypeScript, JavaScript, React, Vue, Svelte, browser, Node, Bun, Deno, Next.js, Nuxt, Remix, TanStack, Angular, or generated TS bindings. |
| spacetimedb-client-rust | Rust client SDK usage, Rust generated bindings, Rust connection code, callbacks, subscriptions, and reducer calls. |
| spacetimedb-client-c-sharp | C# or Unity client SDK usage, generated C# bindings, callbacks, subscriptions, reducer calls, and Unity integration. |
| spacetimedb-client-unreal | Unreal Engine client SDK usage, Unreal generated bindings, connection ticking, subscriptions, and reducers. |
Operations And Reference
| Skill | Load when... |
|---|---|
| spacetimedb-deploy | Deploying to Maincloud, self-hosting, standalone service setup, key rotation, logging, or PGWire. |
| spacetimedb-http | Using HTTP endpoints for identity, database operations, reducer calls, SQL, or authorization headers. |
| spacetimedb-sql | Writing SpacetimeDB SQL for subscriptions, CLI queries, HTTP SQL, DML, literals, identifiers, or SQL performance. |
| spacetimedb-serialization | BSATN, SATS JSON, AlgebraicType/AlgebraicValue encoding, WebAssembly ABI, or low-level module host calls. |
| spacetimedb-tutorials | Following or adapting chat app, Unity Blackhol.io, or Unreal Blackhol.io tutorials. |
Fallback
If the task references a SpacetimeDB API not covered by the router, search the copied reference files in the most likely skill's references/ directory, then inspect src/raw-data-output if this repository is available.