Migration from 0.22.X to 0.23.X

New installation method

Wasp is now installed as a global npm package, instead of the old custom installer. To start using the new installation method, you can run our migration tool:

curl -sSL https://get.wasp.sh/installer.sh | sh -s -- migrate-to-npm

You can read more about it in the Legacy installer guide.

To install the latest Wasp version, open your terminal and run:

npm i -g @wasp.sh/wasp-cli@latest

You can install Wasp 0.23 specifically by passing the version to the install script:

npm i -g @wasp.sh/wasp-cli@0.23

How to migrate?

1. Upgrade Node.js to v24.14.1 or later

Wasp 0.23 requires Node.js >= v24.14.1 (previously >= v22.22.2). Make sure to upgrade before continuing:

node -v
# If below v24.14.1, upgrade:
nvm install 24

2. Bump the Wasp version

Update the version field in your Wasp config to ^0.23.0:

main.wasp

app MyApp {
  wasp: {
    version: "^0.23.0"
  },
  // ...
}

3. Update TypeScript to 5.9.3

Wasp 0.23 requires TypeScript 5.9.3 (previously 5.8.2). Update it in your package.json:

package.json

{
  "devDependencies": {
    "typescript": "5.9.3"
  }
}