The challenge of keeping Backstage up-to-date, is that it is meant as a template for a developer portal, supported by a platform of standardized plugins. Although it is fairly easy to bump the dependencies for the plugins, one also have to update the template, which becomes more and more difficult as changes are made locally. To solve for this, the official documentation recommends that upgrades are made in the following order:
- Bump dependencies using
yarn backstage-cli versions:bump
- Read the @backstage/create-app changelog and/or use the Backstage upgrade helper to modify the code generated by the initial template.