Backstage 1.46.0 Migration Recipe
Runs every @backstage/* v1.46.0 codemod from the registry in a single ordered run.
Codemods included
| # | Package | Domain | Registry |
|---|---|---|---|
| 1 | @backstage/add-jest-peer-dependency | CLI / tooling | link |
| 2 | @backstage/migrate-valkey-config | Backend config | link |
Usage
bash
Out of scope (document only)
These changes require manual attention and are not covered by the recipe:
TechDocsAddonTester.renderWithEffects()screen change — narrow scope, requires new npm dep (shadow-dom-testing-library)- Jest peer dep version choice — the codemod defaults to Jest 30 (recommended); use
--param jestVersion=29for Jest 29 - Jest 30 test code migration — asymmetric matchers, JSDOM 27 changes; see Jest 30 migration guide
getBitbucketCloudRequestOptionsnow returns Promise — narrow internal API- CLI
moduleResolution→bundlerdefault — tsconfig defaults, not consumer code - Node.js 22/24 requirement — runtime environment