From 13c093afb3f8db10fc1da4396a57a7c03a744ec7 Mon Sep 17 00:00:00 2001 From: Peter Macdonald Date: Fri, 19 Dec 2025 11:03:23 +0100 Subject: [PATCH] add copy paste commands Signed-off-by: Peter Macdonald --- docs/tutorials/jest30-migration.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/tutorials/jest30-migration.md b/docs/tutorials/jest30-migration.md index d7e88098d0..f9eec59add 100644 --- a/docs/tutorials/jest30-migration.md +++ b/docs/tutorials/jest30-migration.md @@ -9,8 +9,19 @@ Starting with a recent version of `@backstage/cli`, `jest` is a peer dependency. You can choose to install either Jest 29 or Jest 30. The built-in Jest version before this change was Jest 29, however, we recommend that you switch to Jest 30. Upgrading will solve the `Could not parse CSS stylesheet` errors, allow you to use MSW v2 in web packages, and ensure that you remain compatible with future versions of the Backstage CLI. Support for Jest 29 is temporary, with the purpose of allowing you to upgrade at your own pace, but it will eventually be removed. - **Jest 29**: Install `jest@^29` and `jest-environment-jsdom@^29`. No migration needed, but you may see `Could not parse CSS stylesheet` warnings/errors when testing components from `@backstage/ui` or other packages using CSS `@layer` declarations. + +```sh +# in your repository root, run: +yarn add --dev jest@^29 @types/jest@^29 jest-environment-jsdom@^29 +``` + - **Jest 30**: Install `jest@^30`, `@types/jest@^30`, `@jest/environment-jsdom-abstract@^30`, and `jsdom@^27` in your root `package.json`. Fixes the stylesheet parsing warnings/errors, but requires the migration steps below. +```sh +# in your repository root, run: +yarn add --dev jest@^30 @types/jest@^30 @jest/environment-jsdom-abstract@^30 jsdom@^27 +``` + ## Migration Guide The examples below are issues we encountered while migrating the Backstage repository. For a complete list of breaking changes, see the official documentation: