Skip to main content
Version: Next

Migration from 0.21.X to 0.22.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.22 specifically by passing the version to the install script:

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

What's new in 0.22.X?​

Upgraded Zod to v4​

Wasp now uses Zod v4 for environment variable validation. If you have custom env validation schemas, you may need to update them to be compatible with the latest Zod API. Check the Zod v4 announcement for details on what changed.

How to migrate?​

1. Bump the Wasp version​

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

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

2. Update your env validation schemas​

If you don't have app.client. envValidationSchema or app.server. envValidationSchema defined in your Wasp file, you can skip this step.

Review your schemas for compatibility with Zod v4. Most schemas will work without changes, but some deprecated APIs have been removed. Refer to the Zod v4 migration guide for details.