Migration Guides

Version-by-version upgrade guides for the Nexus SDK and Avail Widgets.

Each guide covers one upgrade step — what changed, why, and the exact renames and rewrites to apply. New guides are added here as new major versions ship.

Current versions

Surface	Package / registry	Current
Nexus SDK	`@avail-project/nexus-core`	2.x
Avail Widgets	`availproject/widgets/nexus` (shadcn registry)	Nexus Widget

Guides

Migrate to Nexus SDK v2

nexus-core 1.x to 2.x — factory client, param renames, per-operation hooks, plan-based events.

Migrate to Nexus Widget

Standalone SwapWidget/FastBridge/FastTransfer/Deposit components to the single unified Nexus Widget.

How is this guide?

Balance Types

Migrate to Nexus SDK v2

Current versions Guides

Edit in GitHub

Migration Guides

Version-by-version upgrade guides for the Nexus SDK and Avail Widgets.

Each guide covers one upgrade step — what changed, why, and the exact renames and rewrites to apply. New guides are added here as new major versions ship.