The major version of Astro as indicated in the website footer and below is the version that should be included in contracts. The associated asset versions should not be referenced in contract language.
Current Version (7.0)
| Astro 7.0 - Updated | ||
|---|---|---|
| Design Language | 7.0 | |
| Design Tokens | 1.12.0 | Release Notes |
| Figma Dark Theme Library | 7.8.1 | Release Notes |
| Figma Light Theme Library | 7.6.1 | Release Notes |
| Figma Wireframe Theme Library | 7.6.1 | Release Notes |
| Astro Templates | 1.0.0 | Release Notes |
| Figma Icon Library | 1.0.1 | |
| Web Components | 7.17.0 -> 7.17.1 | Release Notes |
| EGS Design Compliance | 4.2.0 | |
Previous Major Versions
Visit our Legacy Documentation for more information about Astro V6.
| Version | Status | Released | End of Support |
|---|---|---|---|
| 1.0 | Unsupported | Sep 1, 2015 | Dec 15, 2016 |
| 2.0 | Unsupported | Dec 15, 2016 | April 16, 2018 |
| 3.0 | Unsupported | Apr 16, 2018 | Apr 8, 2019 |
| 4.0 | Unsupported | Apr 8, 2019 | Jan 27, 2021 |
| 5.0 | Unsupported | Jan 27, 2021 | Jul 7, 2022 |
| 6.0 | Unsupported | Oct 27, 2021 | Jan 12, 2023 |
| 7.0 | Supported | Sep 29, 2022 | TBD |
Release Schedule
During 2023, Astro will publish minor and patch updates on a bi-weekly basis on Thursday and major updates on a bi-annual cadence. Astro patch/minor releases may include updates to design assets, compliance, components, design tokens and documentation.
Semantic Versioning
Astro uses Semantic Versioning or SemVer, a widely adopted method of conveying meaning about the change. SemVer is expressed as three numbers delimited by a decimal point (1.4.3). While SemVer has quite a lot of nuance, for Astro we are adopting the basic patch, minor, and major nomenclature.
Unlike standard decimals, each numeral is separated by a full-stop, increments numerically, and resets the numbers to the right. E.g., making a minor change to version 1.9.3 would result in a new version number of 1.10.0. There is no limit to how high each number can go, but practically speaking anything beyond 999 becomes unwieldy.
Web Component Breaking Changes
What to expect
“What is a breaking change?” can be subjective, so we have outlined below explicitly what we are calling breaking changes and what you can expect in each release.
Any changes to this document will be announced in the Astro UXDS Working Group and in our Github Announcements in advance.
Our public API
A component's API includes:
- Properties
- Attributes
- Slots
- Events
- Methods
- CSS Custom Properties
- CSS Shadow Parts
Major
Major releases contain breaking changes.
- We may remove a deprecated component API.
- We may remove a deprecated design token.
- We may remove a deprecated component.
- We may change a component's default behavior.
- We may change an element's dimensions.
Minor
Minor releases include new features and are always backwards compatible. Minor releases may include deprecation warnings where we signal in advance that a particular feature is scheduled to be removed in the next upcoming major release. At your convenience, before the next major release, review the migration steps and upgrade your application accordingly. Minor releases may also include patch features.
- We may add new components.
- We may add a new component API.
- We may add a new design token.
-
We may change CSS properties on internal elements that are exposed publicly as shadow parts.
- For example, changing border to use box-shadow instead.
-
We may change the value of a design token.
- For example, --color-text-primary changes from #E3E3E3 to #e3e3e3.
Patch
Patch releases include bug fixes and should not require you to change your code.
- We can change the internals of the Shadow DOM.
- We will not change a component's width or height.