---
title: 'Migration guides'
description: 'Find stable Wave migration guides by package, starting version, and target version.'
---

These guides cover stable releases that need migration steps or specific validation. For other stable releases, see the [Wave React changelog](https://github.com/Volue/wave/blob/master/react/CHANGELOG.md) and [Wave Core changelog](https://github.com/Volue/wave/blob/master/core/CHANGELOG.md).

Wave Core (`@volue/wave`) and Wave React (`@volue/wave-react`) have independent versions. **From** is the earliest supported stable version; **To** is the target version. Each guide also covers the stable versions between **From** and **To**. Read each guide's prerequisites before changing dependencies.

For upgrades spanning several guides, follow them in order. You do not need to install intermediate versions unless a guide explicitly requires it.

React consumers should start with the Wave React guide when one exists, otherwise use the applicable Wave Core guide. Follow required companion steps once. Shared CSS, font, token, asset, and visual instructions live in the Wave Core guide.

| Release      | Guide                                            | Package             | From     | To      | Released   |
| ------------ | ------------------------------------------------ | ------------------- | -------- | ------- | ---------- |
| Sea turtle   | [Wave React 2.0](/migrations/wave-react/v2.md)   | `@volue/wave-react` | `1.9.0`  | `2.0.0` | 2026-09-29 |
| Sea turtle   | [Wave Core 2.1.1](/migrations/wave/v2.1.1.md)    | `@volue/wave`       | `2.0.0`  | `2.1.1` | 2026-09-29 |
| Wave rebrand | [Wave React 1.9](/migrations/wave-react/v1.9.md) | `@volue/wave-react` | `1.8.0`  | `1.9.0` | 2026-04-28 |
| Wave rebrand | [Wave Core 2.0](/migrations/wave/v2.md)          | `@volue/wave`       | `1.15.0` | `2.0.0` | 2026-04-28 |