Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://gka.github.io/chroma.js/
JavaScript library for all kinds of color manipulations
https://gka.github.io/chroma.js/
chroma coffeescript color-conversion color-manipulation colors javascript-library manipulate-colors
Last synced: 3 months ago
JSON representation
JavaScript library for all kinds of color manipulations
- Host: GitHub
- URL: https://gka.github.io/chroma.js/
- Owner: gka
- License: other
- Created: 2011-12-12T00:33:02.000Z (almost 13 years ago)
- Default Branch: main
- Last Pushed: 2024-01-28T04:32:38.000Z (10 months ago)
- Last Synced: 2024-01-30T15:59:00.080Z (9 months ago)
- Topics: chroma, coffeescript, color-conversion, color-manipulation, colors, javascript-library, manipulate-colors
- Language: JavaScript
- Homepage: https://vis4.net/chromajs/
- Size: 2.78 MB
- Stars: 9,696
- Watchers: 141
- Forks: 606
- Open Issues: 83
-
Metadata Files:
- Readme: readme.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- Colorful - Chroma.js - JavaScript library for dealing with colors. (Tools)
README
# Chroma.js
[Chroma.js](https://vis4.net/chromajs/) is a ~~tiny~~ [small-ish](https://bundlephobia.com/result?p=chroma-js) zero-dependency JavaScript library ([13.5kB](https://bundlephobia.com/result?p=chroma-js)) for all kinds of color conversions and color scales.
[](https://travis-ci.com/gka/chroma.js)
### Usage
Install from npm
```
npm install chroma-js
```
Import package into project
```javascript
import chroma from "chroma-js";
```
Initiate and manipulate colors:
```javascript
chroma('#D4F880').darken().hex(); // #a1c550
```
Working with color scales is easy, too:
```javascript
scale = chroma.scale(['white', 'red']);
scale(0.5).hex(); // #FF7F7F
```
Lab/Lch interpolation looks better than RGB
```javascript
chroma.scale(['white', 'red']).mode('lab');
```
Custom domains! Quantiles! Color Brewer!!
```javascript
chroma.scale('RdYlBu').domain(myValues, 7, 'quantiles');
```
And why not use logarithmic color scales once in your life?
```javascript
chroma.scale(['lightyellow', 'navy']).domain([1, 100000], 7, 'log');
```
### Like it?
Why not dive into the [interactive documentation](http://gka.github.io/chroma.js/) (there's a [static version](https://github.com/gka/chroma.js/blob/master/docs/src/index.md), too). You can download [chroma.min.js](https://raw.github.com/gka/chroma.js/master/chroma.min.js) or use the [hosted version on cdnjs.com](https://cdnjs.com/libraries/chroma-js).
You can use it in node.js, too!
npm install chroma-js
Or you can use it in SASS using [chromatic-sass](https://github.com/bugsnag/chromatic-sass)!
### Build instructions
First clone the repository and install the dev dependencies:
git clone [email protected]:gka/chroma.js.git
cd chroma.js
npm 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
### Similar Libraries / Prior Art
* [Chromatist](https://github.com/jrus/chromatist)
* [GrapeFruit](https://github.com/xav/Grapefruit) (Python)
* [colors.py](https://github.com/mattrobenolt/colors.py) (Python)
* [d3.js](https://github.com/mbostock/d3)
* [Color Art](https://github.com/JiatLn/color-art) (Rust)
### Author
Chroma.js is written by [Gregor Aisch](http://driven-by-data.net).
### License
Released under [BSD license](http://opensource.org/licenses/BSD-3-Clause).
Versions prior to 0.4 were released under [GPL](http://www.gnu.org/licenses/gpl-3.0).
### Further reading
* [How To Avoid Equidistant HSV Colors](https://www.vis4.net/blog/avoid-equidistant-hsv-colors/)
* [Mastering Multi-hued Color Scales with Chroma.js](https://www.vis4.net/blog/mastering-multi-hued-color-scales/)
### FAQ
**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.