Migration from 0.24 to 0.25

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

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

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

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

What's new in 0.25?

TypeScript 6

Wasp now uses TypeScript 6. Your projects will be built with TypeScript 6.0.3, and your project's TypeScript config files need a couple of small updates (see below). Since Wasp runs on Node 24+, tsconfig.wasp.json's target and lib were also bumped to ES2025.

How to migrate?

1. Bump the Wasp version

Update the version field in your Wasp config to ^0.25.0.

Before

main.wasp.ts

export default app({
  wasp: { version: "^0.24.0" },
  // ...
});

After

main.wasp.ts

export default app({
  wasp: { version: "^0.25.0" },
  // ...
});

2. Update your TypeScript config for TypeScript 6

TypeScript 6 no longer automatically includes @types/* packages, so you must list the required type packages explicitly. In tsconfig.wasp.json, also bump target and lib to ES2025.

In tsconfig.wasp.json:

Before

tsconfig.wasp.json

{
  "compilerOptions": {
    // ...
    "target": "ES2022",
    "lib": ["ES2023"]
  }
}

After

tsconfig.wasp.json

{
  "compilerOptions": {
    // ...
    "target": "ES2025",
    "lib": ["ES2025"],
    "types": ["node"]
  }
}

In tsconfig.src.json:

Before

tsconfig.src.json

{
  "compilerOptions": {
    // ...
    "outDir": ".wasp/out/user"
  }
}

After

tsconfig.src.json

{
  "compilerOptions": {
    // ...
    "outDir": ".wasp/out/user",
    "types": ["react", "node"]
  }
}

In package.json, update the typescript dev dependency to 6.0.3:

Before

package.json

{
  "devDependencies": {
    // ...
    "typescript": "5.9.3"
  }
}

After

package.json

{
  "devDependencies": {
    // ...
    "typescript": "6.0.3"
  }
}

3. Enjoy your updated Wasp app

That's it!