About spacetimedb-upgrade
A migration skill for developers moving SpacetimeDB projects from 1.0 to 2.0. It organizes checks by breaking change and points to the migration guide and regenerated client APIs.
Key features
- 01Check callback and event type changes
- 02Update subscription APIs and table accessors
- 03Review database connection naming
- 04Handle Rust and C++ sender changes
- 05Check update methods and other migration areas
Use cases
- 01Migrate a SpacetimeDB project from 1.0 to 2.0
- 02Investigate client subscription and event handling changes
- 03Review codegen, scheduled functions, and other migration topics
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ danmossa/ spacetimedb-skills --skill spacetimedb-upgradeAfter installing, type/spacetimedb-upgradein Claude Code to confirm it loaded.
Bundled filesreferences/upgrade.md
Details
From the project READMEUse this skill for SpacetimeDB 1.0 to 2.0 migration work.
Core migration checks
- Reducer callbacks changed. Prefer event tables for durable, subscribable result notifications; use per-call
_then()style callbacks only when the guide's limitations are acceptable. - Event types changed. Update client event handling before assuming old reducer-result event shapes still exist.
- Subscription APIs and table accessor names changed. Regenerate bindings and update calls to the generated names rather than patching guessed identifiers.
- Clients connect by database name or identity, not the old module naming assumptions.
- In Rust and C++,
senderis now a method: usectx.sender(). TypeScript and C# property syntax is unchanged. - Only primary keys get generated update methods. For other changes, update through the primary-key index or delete and insert when the primary key changes.
- Scheduled functions, private codegen, light mode,
CallReducerFlags, and confirmed reads all have separate migration notes. Load the guide section before editing those areas.
Reference map
| Need | Open |
|---|---|
| Migration guide and checklist | references/upgrade.md |
Guidance
- Identify the exact breaking change before editing code; the guide has separate remedies for callbacks, events, subscriptions, table naming, connection names,
sender, updates, scheduling, codegen, light mode, flags, and confirmed reads. - Prefer event tables over old reducer callback patterns when the guide recommends them.
- Check generated client APIs after changing module names, table accessors, visibility, or private items.
Comments
Markdown supported