Repository files navigation

Chroma.js is atinysmall-ish zero-dependency JavaScript library for all kinds of color conversions and color scales.

Install from npm

npm install chroma-js

Import package into project

importchromafrom"chroma-js";

Initiate and manipulate colors:

chroma('#D4F880').darken().hex();// #a1c550

Working with color scales is easy, too:

scale=chroma.scale(['white','red']);scale(0.5).hex();// #FF7F7F

Lab/Lch interpolation looks better than RGB

chroma.scale(['white','red']).mode('lab');

Custom domains! Quantiles! Color Brewer!!

chroma.scale('RdYlBu').domain(myValues,7,'quantiles');

And why not use logarithmic color scales once in your life?

chroma.scale(['lightyellow','navy']).domain([1,100000],7,'log');

Why not dive into theinteractive documentation (there's astatic version, too). You can downloadchroma.min.js or use thehosted version on cdnjs.com.

You can use it in node.js, too!

npm install chroma-js

Or you can use it in SASS usingchromatic-sass!

Come over and say hi in ourDiscord channel!

First clone the repository and install the dev dependencies:

git clone git@github.com:gka/chroma.js.gitcd chroma.jsnpm install

Then compile the coffee-script source files to the build files:

npm run build

Don't forget to tests your changes! You will probably also want to add new test to the/test folder in case you added a feature.

npm test

And to update the documentation just run

npm run docs

To preview the docs locally you can use

npm run docs-preview

• Chromatist
• GrapeFruit (Python)
• colors.py (Python)
• d3.js
• Color Art (Rust)

Chroma.js is written byGregor Aisch.

Released underBSD license.Versions prior to 0.4 were released underGPL.

• How To Avoid Equidistant HSV Colors
• Mastering Multi-hued Color Scales with Chroma.js

There have been no commits in X weeks. Is chroma.js dead?

No! It's just that the author of this library has other things to do than devoting every week of his life to making cosmetic changes to a piece of software that is working just fine as it is, just so that people like you don't feel like it's abandoned and left alone in this world to die. Bugs will be fixed. Some new things will come at some point. Patience.

I want to help maintaining chroma.js!

Yay, that's awesome! Please say hi at ourDiscord chat to get in touch