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.

React Router 8

Wasp now uses React Router 8. The upgrade is backwards compatible for typical usage (e.g. Link, NavLink, Outlet), so you only need to bump the react-router dependency.

Vite 8

Wasp now uses Vite 8, which is powered by a new native bundler, for faster builds. Testing moves to Vitest 4.1 to stay compatible.

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 dependencies in package.json

Bump Wasp-required dependencies to their latest version:

Before

package.json

{
  "dependencies": {
    // ...
    "react-router": "^7.12.0"
  },
  "devDependencies": {
    // ...
    "@tailwindcss/vite": "^4.1.18", // only if present
    "typescript": "5.9.3",
    "vite": "^7.0.6",
    "vitest": "^4.0.16"
  }
}

After

package.json

{
  "dependencies": {
    // ...
    "react-router": "^8.0.1"
  },
  "devDependencies": {
    // ...
    "@tailwindcss/vite": "^4.3.1", // only if present
    "typescript": "6.0.3",
    "vite": "^8.1.0",
    "vitest": "^4.1.9"
  }
}

3. 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"]
  }
}

4. Enjoy your updated Wasp app

That's it!