Skip to content
This repository has been archived by the owner on May 19, 2022. It is now read-only.

Clarity is a scalable, accessible, customizable, open source design system built with web components. Works with any JavaScript framework, built for enterprises, and designed to be inclusive.



Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Failed to load latest commit information.
Latest commit message
Commit time

NOTE: The Clarity Design System has moved and is now split into two repositories, one for Clarity Angular and one for Clarity Core. This repository is now for archived purposes only.


Clarity Design System


Clarity is an open source design system that brings together UX guidelines, design resources, and coding implementations with Web Components. This repository includes everything you need to build, customize, test, and deploy Clarity. For complete documentation, visit the Clarity website.

If you are looking for Clarity Angular, our previous implementation of Clarity built in Angular, please see the angular branch for the latest version there.

Getting Started

Clarity is published as five npm packages:

  • npm version core Contains the Web Components that work in any JavaScript framework.
  • npm version cds angular Contains shims for core usage in Angular environment
  • npm version cds react Contains shims for core usage in React environment
  • npm version clarity city Our open source sans-serif typeface.

Installing Clarity

Visit our documentation at


For documentation on the Clarity Design System, including a list of components and example usage, see our website.


The Clarity project team welcomes contributions from the community. For more detailed information, see our contribution guidances.


  • The Clarity Design System is licensed under the MIT license.


If you find a bug or want to request a new feature, please open a GitHub issue.

Include a link to the reproduction scenario you created by forking one of the Clarity Stackblitz Templates for the version you are using at Clarity StackBlitz templates.


For our support policies please visit

For questions, ideas, or just reaching out to the team feel free to open a discussion in our GitHub Disscussion section.