Migration from 0.25 to 0.26

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

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

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

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

What's new in 0.26?

How to migrate?

1. Bump the Wasp version

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

Before

main.wasp.ts

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

After

main.wasp.ts

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

And run the following command to update the Wasp libraries in your project:

wasp install

2. Update your TypeScript config

Due to wasp/sdk package changes, we require some changes to your TypeScript configuration.

In tsconfig.src.json, update the include field:

Before

tsconfig.src.json

{
  "compilerOptions": {
    // ...
  },
  "include": ["src"]
}

After

tsconfig.src.json

{
  "compilerOptions": {
    // ...
  }, 
  "include": ["src", ".wasp/out/types/app"]
}

3. Add the Wasp server plugin to your Vite config

Wasp now runs and bundles your server with Vite, through a plugin you must add to your Vite config: waspServer() from wasp/server/vite.

Before

vite.config.ts

import { defineConfig } from "vite";
import { wasp } from "wasp/client/vite";

export default defineConfig({
  plugins: [wasp()],
});

After

vite.config.ts

import { defineConfig } from "vite";
import { wasp } from "wasp/client/vite";
import { waspServer } from "wasp/server/vite";

export default defineConfig({
  plugins: [wasp(), waspServer()],
});

Keep any other plugins (like Tailwind CSS) after these two.

4. Update your custom Dockerfile

If you are using a custom Dockerfile, due to wasp/sdk package changes, you'll have to add a one new additional line to it:

Before

Dockerfile

# ...
COPY sdk .wasp/out/sdk
COPY libs .wasp/out/libs
# ...

After

Dockerfile

# ...
COPY sdk .wasp/out/sdk
COPY types .wasp/out/types
COPY libs .wasp/out/libs
# ...

5. Enjoy your updated Wasp app

That's it!