DefinitelyTyped icon, indicating that this package has TypeScript declarations provided by the separate @types/carbon__colors package

    10.34.0 • Public • Published


    Colors for digital and software products using the Carbon Design System

    Getting started

    To install @carbon/colors in your project, you will need to run the following command using npm:

    npm install -S @carbon/colors

    If you prefer Yarn, use the following command instead:

    yarn add @carbon/colors


    You can use the @carbon/colors module in your JavaScript, in addition to your Sass.


    In Sass, you can import the files individual by doing:

    @import '@carbon/colors/scss/colors';

    This file automatically includes the carbon--colors mixin which initializes all the color variables for the IBM Design Language.

    These color variables follow the naming convention: $carbon--<swatch>-<grade>. For example:


    You can also use the shorthand form of these colors by dropping the carbon-- namespace:


    Note: the shorthand variables require that you do not have any other conflicting variables in your setup. Namespaced variables are always preferred for this reason, unless you are confident that no collisions will occur.

    If you would like you choose when these variables are defined, then you can call the carbon--colors mixin directly by importing the following file:

    @import '@carbon/colors/scss/mixins';
    // ...
    @include carbon--colors();

    Alongside the color variables detailed above, we also provide a map of colors so that you can programmatically use these values. This map is called $carbon--colors and each key is the name of a swatch. The value of these swatches is also a map, but each key is now the grade. In code, this looks like the following:

    $carbon--colors: (
      'blue': (
        10: #edf4ff,
        // ...

    You can include this variable by including @carbon/colors/scss/colors or calling the carbon--colors() mixin directly.

    Migrating from previous versions

    If you were originally using a project that had color variables defined as $ibm-color__<swatch>-<grade>, or are relying on $ibm-color-map, you can also use the entrypoint described above to access these colors. They are meant as an easier way to help adopt these packages. However, these variables will be removed in the next release of Carbon.

    Similar to previous efforts, we also provide colors in the formats mentioned above. For example:


    If you would like a mixin to conditionally include these variables, you can include the mixin by using:

    @import '@carbon/colors/scss/mixins';
    @include ibm--colors();


    For JavaScript, you can import and use this module by doing the following in your code:

    // ESM
    import { black, blue, warmGray } from '@carbon/colors';
    // CommonJS
    const { black, blue, warmGray } = require('@carbon/colors');

    Each color swatch is exported as a variable, and each color name is also exported as an object that can be called by specifying grade, for example:

    blue[50]; // Using the `blue` object.
    warmGray100; // Using the `warmGray100` variable.

    📚 Examples

    If you're looking for more examples on how to use @carbon/colors, we have some examples that you can check out:

    🙌 Contributing

    We're always looking for contributors to help us fix bugs, build new features, or help us improve the project documentation. If you're interested, definitely check out our Contributing Guide! 👀

    📝 License

    Licensed under the Apache 2.0 License.


    npm i @carbon/colors

    DownloadsWeekly Downloads






    Unpacked Size

    131 kB

    Total Files


    Last publish


    • dcwarwick
    • jdharvey
    • carbon-design-system
    • joshblack
    • carbon-bot
    • tjegan
    • alisonjoseph
    • adavila
    • shinytoyrobots
    • magedhennawy
    • leechase
    • vpicone
    • dakahn
    • jnm2377
    • jeffreychew
    • simonfinney
    • sstrubberg
    • andreancardona
    • tay1orjones