JSPM

color-name-list

3.69.0
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 19955
  • Score
    100M100P100Q142556F
  • License MIT

long list of color names

Package Exports

  • color-name-list

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (color-name-list) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

17634 color-names

GitHub release npm version npm Travis color count Buy Me a Coffee at ko-fi.com

A handpicked list of 17634 unique color names from various sources and thousands of user submissions. Try it yourself or read the full list.

The names of color function like a thread attached to a frightfully slender needle, capable of stitching together our most delicate emotions and memories. When the needle hits the target, we feel either pleasure or empathy. Kenya Hara – White

About 📋

The aim of this project is to create as large a list of color names as possible. We've merged various lists, modified the names when there were duplicates with different hex values, and shifted the colors a bit when there were identical colors with different names.

Submit a color via form 🌈 / or twitter 🐦

Make sure to read the naming rules before you contribute!

color count: 17634 🎉

(~0.11% of all RGB Colors)

Color distribution 🛰

3d representation of color distribution in RGB Space (Preview image of link above) When coming up with new color names, it is vital to know what spots in a certain color-space are crowded and where there is still room for new colors. For example: Our API returns the closest RGB color to a given HEX value. To avoid too many colors snapping to the same name, we aim to distribute the colors evenly in the color space: Visualization

PS: You can choose between different color spaces on the bottom right.

Usage 📖

Installation Node.js 📦

npm install color-name-list --save

or yarn add color-name-list

CDN 🌍 JSON / CSV / YML / JS / XML / HTML / SCSS

API 🃏

https://api.color.pizza/v1/{{hexvalue without the #}},{{more comma separated values}}

Single Color

curl https://api.color.pizza/v1/212121

{
  "colors": [{
    "name": "Lead",
    "hex": "#212121",
    "rgb": {"r": 33, "g": 33, "b": 33},
    "distance": 0, // its an exact match
    "luminance": 22.062320231562225,
    "requestedHex": "#212121",
  }]
}

Multiple Colors

curl https://api.color.pizza/v1/212121,060606,ff0012,550055,123456

All Named Colors

curl https://api.color.pizza/v1/

In this case colors is not an object but an array of objects sorted by color-name

Unique Color-Names

by adding ?noduplicates=true every returned name will be unique. The closest color, that was not returned previously will be returned: curl https://api.color.pizza/v1/212121,212121?noduplicates=true

{
  "colors": [{ 
    "name": "Lead",
    "hex": "#212121",
    "rgb": { "r": 33, "g": 33, "b": 33 },
    "luminance": 22.062320231562225 
  },{ 
    "name": 'Abaddon Black',
    "hex": '#231f20',
    "rgb": { "r": 35, "g": 31, "b": 32 },
    "luminance": 21.30621829419759 
  }]
}

Usage JS ⌨

Exact Color

import namedColors from 'color-name-list';

let someColor = namedColors.find(color => color.hex === '#ffffff');
console.log(someColor.name); // => white

let someNamedColor = namedColors.find(color => color.name === 'Eigengrau')
console.log(someColor.hex); // => #16161d

Closest Named Color

Since there are 16777216 possible RGB colors, you might use a library such as nearest-color to help you find the the closest named color. Since there are 16777216 possible RGB colors, you might use a library such as ClosestVector to help you find the the closest named color.

import nearestColor from 'nearest-color';
import namedColors from 'color-name-list';

// nearestColor need objects {name => hex} as input
const colors = colorNameList.reduce((o, { name, hex }) => Object.assign(o, { [name]: hex }), {});

const nearest = nearestColor.from(colors);

// get closest named color
nearest('#f1c1d1'); // => Fairy Tale

Alternative package: ktree

Note: If you are looking for something visually more accurate, you could: use DeltaE, or use the above snippet, combined with a transform from rgb to ciecam02 scaled to 0-255.

Building 🔨

npm install && npm run build

See package.json for more.

Sources 🗒

Sources: Names 📇

Sources: Color 🎨

Contributors 🦑

Disclaimer 👮🏾‍

In the process we try to remove all names that are offensive or racist, as well as protected brand names. As some of the color names come from other lists, some bad ones might slip in. Please report them, they will be removed as quickly as possible.