8.12.0 โ€ข Published 13 days ago

color-name-list v8.12.0

Weekly downloads
7,433
License
MIT
Repository
github
Last release
13 days ago

handpicked color names

Actions Status GitHub release npm version npm name count

A handpicked list of 28808 unique color names from various sources and thousands of curated user submissions.

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 while maintining a good name quality. 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.

Explore ๐ŸŒ

Color Name Submission ๐Ÿ’Œ

via form ๐ŸŒˆ / or twitter ๐Ÿฆ

Make sure to read the naming rules before you contribute!

Color Count: 28808 ๐ŸŽ‰

~0.17% of the RGB color space

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

Usage ๐Ÿ“–

Installation Node.js ๐Ÿ“ฆ

npm install color-name-list --save

or yarn add color-name-list

CDN ๐ŸŒ

All Names ๐Ÿ“š

JSON / JSON.min / CSV / YML / JS / XML / HTML / SCSS

Best of Names subset ๐Ÿ†

JSON / JSON.min / CSV / YML / JS / XML / HTML / SCSS / CSS

API ๐Ÿƒ

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

or

https://api.color.pizza/v1/?values={{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 or curl https://api.color.pizza/v1/?values=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/?values=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
  }]
}

Search for colors by name

https://api.color.pizza/v1/names/{{query}}

or

https://api.color.pizza/v1/names/?name={{query}}

Returns an array of color objects which match the given query, sorted by color-name: curl https://api.color.pizza/v1/names/red

Good Color-Names

Not all color-names are created equal; add ?goodnamesonly=true to your request URL to get a handpicked subset of names that were rated as good by humans. (Colors that are liked a lot on twitter and some of the team favourites).

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 or 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 ๐Ÿฆ‘

Costs & Sponsors

Sponsors

Project Costs USD

One-Time

ItemExpenditure
Logo by Metafizzy800

Periodic

ItemExpenditure
Color Name API Server264.60/year
color.pizza domain name36.16/year
Cloudflare PRO Plan240/year

Color Namers

Verena the naming overloard, Jess the name wizzard, Syl, Stephanie Stutz, Simbiasamba, Jason Wilson, Inรชs Joรฃo, Nick Niles, Qwhex, Ichatdelune, basgys, Shelina S., Trevor Elia, cheesits456, Sandhya Subram, BerylBucket, Jimmy Fitzback, TLZ, DarthTorus, Carrion, BlueChaos

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.

Latest Color Names ๐Ÿ”–

New colors

8.12.0

13 days ago

8.11.0

29 days ago

8.4.0

2 months ago

8.5.0

2 months ago

8.6.0

2 months ago

8.7.0

2 months ago

8.8.0

1 month ago

8.10.0

30 days ago

8.9.0

1 month ago

8.3.0

2 months ago

8.1.0

2 months ago

8.2.0

2 months ago

8.0.0

2 months ago

7.45.0

2 months ago

7.45.1

2 months ago

7.44.0

2 months ago

7.43.0

2 months ago

7.42.0

2 months ago

7.41.0

3 months ago

7.40.0

3 months ago

7.39.0

3 months ago

7.38.0

3 months ago

7.37.0

3 months ago

7.36.0

3 months ago

7.35.0

3 months ago

7.34.0

3 months ago

7.33.1

3 months ago

7.33.0

3 months ago

7.32.0

3 months ago

7.31.0

4 months ago

7.30.0

6 months ago

7.29.0

6 months ago

7.28.0

6 months ago

7.27.0

6 months ago

7.26.0

6 months ago

7.25.0

6 months ago

7.24.0

6 months ago

7.23.0

6 months ago

7.22.0

6 months ago

7.21.0

7 months ago

7.20.0

7 months ago

7.19.0

7 months ago

7.18.0

7 months ago

7.17.0

7 months ago

7.16.0

7 months ago

7.15.0

7 months ago

7.14.0

8 months ago

7.13.0

8 months ago

7.11.0

8 months ago

7.12.0

8 months ago

7.10.0

8 months ago

7.9.0

8 months ago

7.8.0

9 months ago

7.6.0

9 months ago

7.7.1

9 months ago

7.7.0

9 months ago

7.5.0

9 months ago

7.4.0

9 months ago

7.3.0

9 months ago

7.2.0

9 months ago

7.1.0

9 months ago

7.0.1

9 months ago

7.0.0

9 months ago

6.16.0

9 months ago

6.15.0

9 months ago

6.14.0

9 months ago

6.13.0

10 months ago

6.12.0

10 months ago

6.12.1

10 months ago

6.11.1

10 months ago

6.11.0

10 months ago

6.10.1

10 months ago

6.10.0

10 months ago

6.9.0

10 months ago

6.6.0

10 months ago

6.7.0

10 months ago

6.8.0

10 months ago

6.5.1

11 months ago

6.5.0

11 months ago

6.3.0

11 months ago

6.4.0

11 months ago

6.1.0

11 months ago

6.2.0

11 months ago

6.0.0

11 months ago

5.32.0

11 months ago

5.31.0

12 months ago

5.30.0

12 months ago

5.29.0

12 months ago

5.28.0

1 year ago

5.27.0

1 year ago

5.24.0

1 year ago

5.25.0

1 year ago

5.26.0

1 year ago

5.23.0

1 year ago

5.22.0

1 year ago

5.21.0

1 year ago

5.20.0

1 year ago

5.19.0

1 year ago

5.18.0

1 year ago

5.16.0

1 year ago

5.17.0

1 year ago

5.15.0

1 year ago

5.14.0

1 year ago

5.13.0

1 year ago

5.11.0

1 year ago

5.12.0

1 year ago

5.9.0

1 year ago

5.10.0

1 year ago

5.8.0

1 year ago

5.7.0

1 year ago

5.6.0

1 year ago

5.5.0

1 year ago

5.4.1

1 year ago

5.4.0

1 year ago

5.3.0

1 year ago

5.2.0

1 year ago

5.0.0

1 year ago

5.1.0

1 year ago

4.15.0

1 year ago

4.14.0

1 year ago

4.13.0

1 year ago

4.12.0

1 year ago

4.11.0

2 years ago

4.10.0

2 years ago

4.9.0

2 years ago

4.8.0

2 years ago

4.7.1

2 years ago

4.7.0

2 years ago

4.6.0

2 years ago

4.5.0

2 years ago

4.4.0

2 years ago

4.3.0

2 years ago

4.2.0

2 years ago

4.1.0

2 years ago

4.0.0

2 years ago

3.89.0

2 years ago

3.88.1

2 years ago

3.88.0

2 years ago

3.87.0

2 years ago

3.86.0

2 years ago

3.85.0

2 years ago

3.84.0

2 years ago

3.83.0

2 years ago

3.82.0

2 years ago

3.81.0

2 years ago

3.80.0

2 years ago

3.79.0

2 years ago

3.78.0

2 years ago

3.77.0

2 years ago

3.76.0

2 years ago

3.75.0

2 years ago

3.74.0

2 years ago

3.73.0

2 years ago

3.72.0

2 years ago

3.71.0

2 years ago

3.70.0

2 years ago

3.69.0

2 years ago

3.68.0

2 years ago

3.67.0

2 years ago

3.66.0

2 years ago

3.65.0

2 years ago

3.64.0

2 years ago

3.63.0

2 years ago

3.62.0

2 years ago

3.61.0

2 years ago

3.60.0

2 years ago

3.59.0

2 years ago

3.58.0

2 years ago

3.57.0

2 years ago

3.56.0

2 years ago

3.55.0

2 years ago

3.54.0

2 years ago

3.53.0

2 years ago

3.52.1

3 years ago

3.52.0

3 years ago

3.51.0

3 years ago

3.50.0

3 years ago

3.49.0

3 years ago

3.48.1

3 years ago

3.48.0

3 years ago

3.47.0

3 years ago

3.46.0

3 years ago

3.45.0

3 years ago

3.44.0

3 years ago

3.43.0

3 years ago

3.42.0

3 years ago

3.41.0

3 years ago

3.40.0

3 years ago

3.39.0

3 years ago

3.38.0

3 years ago

3.37.0

3 years ago

3.36.0

3 years ago

3.35.0

3 years ago

3.34.0

3 years ago

3.33.0

3 years ago

3.32.0

3 years ago

3.31.0

3 years ago

3.30.0

3 years ago

3.29.0

3 years ago

3.28.0

3 years ago

3.27.0

3 years ago

3.26.0

3 years ago

3.25.0

3 years ago

3.24.0

3 years ago

3.23.0

3 years ago

3.22.1

3 years ago

3.22.0

3 years ago

3.21.0

3 years ago

3.20.0

3 years ago

3.19.0

3 years ago

3.18.0

3 years ago

3.17.0

3 years ago

3.16.0

3 years ago

3.15.0

3 years ago

3.14.1

3 years ago

3.14.0

3 years ago

3.13.0

3 years ago

3.12.0

3 years ago

3.11.0

3 years ago

3.10.0

3 years ago

3.9.1

3 years ago

3.9.0

4 years ago

3.8.3

4 years ago

3.8.2

4 years ago

0.1.0

4 years ago

0.0.1

4 years ago

0.0.0

4 years ago

3.8.1

4 years ago

3.8.0

4 years ago

3.7.0

4 years ago

3.6.0

4 years ago

3.5.0

4 years ago

3.4.4

4 years ago

3.4.3

4 years ago

3.4.2

4 years ago

3.4.1

4 years ago

3.4.0

4 years ago

3.3.2

4 years ago

3.3.1

4 years ago

3.3.0

4 years ago

3.2.2

4 years ago

3.2.1

4 years ago

3.2.0

4 years ago

3.1.0

4 years ago

3.0.0

4 years ago

2.6.0

4 years ago

2.5.0

4 years ago

2.4.0

4 years ago

2.3.0

4 years ago

2.2.0

4 years ago

2.1.1

4 years ago

2.1.0

4 years ago

2.0.2

4 years ago

2.0.1

4 years ago

2.0.0

4 years ago

1.9.0

4 years ago

1.8.0

4 years ago

1.7.0

4 years ago

1.6.1

4 years ago

1.6.0

4 years ago

1.5.0

4 years ago

1.4.1

4 years ago

1.4.0

4 years ago

1.3.0

4 years ago

1.2.0

4 years ago

1.1.0

4 years ago

1.0.4

4 years ago

1.0.3

4 years ago

1.0.2

4 years ago

1.0.1

4 years ago

1.0.0

4 years ago