mcpField
S
spacetimedb-upgrade

spacetimedb-upgrade

github.com/danmossaDevelopment2154 installsUpdated 19w ago
Repository

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

  1. 01Check callback and event type changes
  2. 02Update subscription APIs and table accessors
  3. 03Review database connection naming
  4. 04Handle Rust and C++ sender changes
  5. 05Check update methods and other migration areas

Use cases

  1. 01Migrate a SpacetimeDB project from 1.0 to 2.0
  2. 02Investigate client subscription and event handling changes
  3. 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-upgrade

After installing, type/spacetimedb-upgradein Claude Code to confirm it loaded.

Bundled filesreferences/upgrade.md

Details

From the project README

Use 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++, sender is now a method: use ctx.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

NeedOpen
Migration guide and checklistreferences/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