Carbon

Carbon is a React component library developed by Sage.

Getting started

Our getting started guide provides instructions on how to install and use the Carbon library.

Examples

See our docs for live examples.

Agent skills

After installing carbon-react, add the Carbon agent skills to your project:

shell
npx skills add Sage/carbon

The above script will pull the latest skills, if you need to version them you can do the following (please note skills were added in v158.35.6):

shell
npx skills add https://github.com/Sage/carbon/tree/v158.50.0/skills/carbon-react

These skills give agents full context about the Carbon library, including component props, usage examples, deprecation notices, migration guides, and documentation references.

Browser Support

We support and test the Carbon Library against the latest versions of the following browsers:

We provide polyfills for the latest two versions of each of these browsers to give a grace period to update.

Versioning

We follow Semantic Versioning and we use Conventional Commits.

While we make every effort to avoid breaking changes, sometimes they are necessary. We choose to take an overly cautious
approach to breaking changes. That is we will mark something as a breaking change, even if it is extremely unlikely to affect any consumers.

We choose to make frequent but small breaking changes to give you the choice of making small incremental updates or by jumping multiple versions
in one upgrade. Ultimately the amount of breaking changes is the same, but version number increases more frequently.

We will batch breaking changes into a single version if there is a technical reason why we can't make a small breaking change, or if the impact is extraordinarily low.

We publish release notes that include the necessary upgrade steps. We also publish a codemod when possible, this will update your code to work with the new version.

For more information please see the GitHub releases.