Skip to main content
Releasing makes the current version of your design system available to the other projects in your organization. Projects linked to it keep the release they have until they choose to update.

Release a version

  1. Open the design system. When it has changes no release includes yet, a card above the generation input says RELEASE YOUR DESIGN SYSTEM.
  2. Click Release on the card. You can also release from the version card in the chat, on the version you are viewing.
  3. In Release new version, pick a Version Type. Version Preview shows the current release and the new number.
  4. Click Release. Linked projects can now update to it.
The release is the version you are viewing. Release is disabled while a generation runs (You can’t release while there is a generation in progress).

Version types

Minor is picked by default. A first release with Minor is v0.1.0.

Releases come from the default branch

Other projects get releases from the design system’s default branch, usually main. On another branch, the release dialog says Only main can be released (with your default branch’s name) and offers Switch to main, also named after your default branch. Merge your branch first, then release. See Branches.

After a release

  • Project settings > Design System in the design system shows Current version, Last updated and Total versions.
  • Versions from before the latest release can no longer be rolled back to or released. Hovering Rollback on one says Cannot rollback - a newer version has been released.
  • A released design system cannot be deleted from the projects page. Contact support instead.