Strato versioning and releases
- Concept
- 5 minutes
Keep your apps running smoothly by staying up-to-date with the latest Strato versions. Regular updates help you get the most value from the Strato Design System and avoid potential problems.
This page explains Strato versioning, release cadence, release notes, and how to update Strato packages.
Versioning
Strato uses semantic versioning, which follows these rules:
- Version numbers have the format MAJOR.MINOR.PATCH.
- All changes to the code are aggregated, versioned, and released according to these types:
- MAJOR release for breaking changes.
- MINOR release for feature updates and other non-breaking changes.
- PATCH release for bug fixes for earlier releases.
Release cadence
Release version | Cadence | Includes (see Definitions) |
---|---|---|
MAJOR | Preview components - quarterly; Stable components - twice per year | Breaking changes, peer dependency updates, removal of deprecated components |
MINOR | Every two weeks | Feature updates and improvements that are fully compatible with earlier versions. |
PATCH | As needed | Bug fixes |
Lifecycle states
Strato components and tokens exist in three different states:
Preview
- Component or token is usable but still in active development.
- Expect quarterly breaking changes.
- Expect frequent updates for new features and fixes.
Stable
- Component or token is well-tested and refined.
- Expect predictable behaviors and stable dependencies.
- Expect a maximum of two breaking changes per year. (Some components have none.)
Deprecated
- Components and tokens are replaced by something newer or no longer needed.
- Components and tokens may be deprecated at any time but won't be removed from the design system until the next MAJOR release (minimum 1 month notice).
- Deprecations are documented in Upcoming changes (pre-release) and Release notes (post-release).
Update Strato packages
We strongly recommend updating the packages in your environment every two weeks to ensure that all new features and fixes are incorporated.
dt-app update
Use the dt-app update
command in your terminal to update all Strato packages at once:
npx dt-app update
This command will update all Strato packages and run any necessary migrations in your environment. All details are provided in the terminal when you run the command.
See the Dynatrace App Toolkit Command reference for more commands.