Home

Awesome

<picture> <source media="(prefers-color-scheme: dark)" srcset="https://github.com/hashicorp/design-system/assets/788096/5d6969b7-f8b4-4ad3-9ece-b16b4527522e" width="300"> <source media="(prefers-color-scheme: light)" srcset="https://github.com/hashicorp/design-system/assets/788096/8e278094-427f-40cc-912f-9ccd3a0ff879" width="300"> <img alt="Helios Design System" src="https://github.com/hashicorp/design-system/assets/788096/8e278094-427f-40cc-912f-9ccd3a0ff879.png" width="300"> </picture>

The Helios Design System provides the building blocks to design and implement consistent, accessible, and delightful product experiences across HashiCorp.

Usage

For guidelines on how to use Helios, see our documentation website.

Release notes

A changelog for code and Figma changes is kept on the Helios website

Packages

packages/components npm version

Design System components in Ember.js

packages/ember-flight-icons npm version

Ember.js addon with <FlightIcon /> component (deprecated)

packages/flight-icons npm version

Flight icons in different formats (SVG/SVG Sprite/React)

packages/tokens npm version

Design tokens

Contributing

Workspaces

This monorepo uses yarn workspaces to manage dependencies for all packages.

Adding new packages

Run this command from the monorepo root:

yarn workspace <workspace-npm-package> add --dev <npm-package>

e.g. yarn workspace @hashicorp/design-system-components add --dev ember-cli-flash

Using ember install in the monorepo

Run this command from the monorepo root:

yarn workspace <workspace-npm-package> run ember install <npm-package>

e.g. yarn workspace @hashicorp/design-system-components run ember install ember-a11y-refocus

Changesets

This project uses changesets to manage how changes will be released. Each user-facing change to a package should come with a changeset for each package that has changed.

To create a changeset, run and follow the prompts in your terminal:

yarn changeset

See the changeset docs for more information.

Note: If you want to ignore a changeset bump in terminal (e.g. major bump for selected "package x" is N/A, want a patch release), press return on the command line to skip that step. Press the spacebar to select that step.

Releasing

See the release docs for the process we follow to publish a new package version.

License

This project is licensed under the Mozilla Public License 2.0.

Versioning

We use SemVer for versioning.