Javascript module for generating random, distinguishable, pleasing colors (ie: for chart series).
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
dist target node for main build Feb 18, 2017
.babelrc refactor src Feb 18, 2017
.gitignore cleanup; fix randomization Feb 18, 2017
.travis.yml update deps Feb 18, 2017 link to example Feb 23, 2017
package.json update manifest Feb 23, 2017
webpack.config.js target node for main build Feb 18, 2017

Random Color

Coverage Status

Random color is a simple javascript module for generating random colors that contrast enough to distinguish between one another, and are not too loud (by default, all colours can have readable black/dark font overlayed).


Useful, for example, in charts and diagrams where X number of series need to be distinguished by color.

Getting it


npm install rcolor


Clone this repo / copy dist/rcolor.min.js

Note that the dist/rcolor.js file is a CommonJS export (the node.js build)

Using it

With the browser build:

// > "#79f2ab"

With the node build:

const color = require('rcolor')
color() // "#79f2ab"

Options / Configuration

You can specify the hue, saturation and value. The following are the defaults:

const goldenRatio = 0.618 // ... truncated

  hue: (Math.random() + goldenRatio) % 1,
  saturation: 0.5,
  value: 0.95


If you used this module prior to NPM availability (between 2013 and 2017), you can find that source (including the Dart version) on the legacy branch.


Free to use and distribute under the MIT license.

Sorry, Colour

Apologies in advance to my commonwealth friends, if you find 'color' vs. 'colour'. It was a hard decision for a Canadian. :)

Wes Johnson @SterlingWes