Color Name

Color Name is a JavaScript library that provides a comprehensive mapping of standardized CSS color names to their corresponding RGB values. Based on the W3C CSS color specifications, it offers a simple data structure containing 148 named colors with their precise RGB representations.

Package Information

• Package Name: color-name
• Package Type: npm
• Language: JavaScript
• Installation: npm install color-name

Core Imports

CommonJS (primary export format):

const colors = require('color-name');

ESM (if using with bundlers that support CommonJS to ESM conversion):

import colors from 'color-name';

Basic Usage

const colors = require('color-name');

// Access color RGB values by name
console.log(colors.red);        // [255, 0, 0]
console.log(colors.blue);       // [0, 0, 255]
console.log(colors.green);      // [0, 128, 0]

// Use for color conversion functions
function rgbToHex(colorName) {
  const rgb = colors[colorName];
  if (!rgb) return null;
  return '#' + rgb.map(c => c.toString(16).padStart(2, '0')).join('');
}

console.log(rgbToHex('crimson')); // "#dc143c"

// Check if a color exists
function hasColor(name) {
  return name in colors;
}

console.log(hasColor('purple'));    // true
console.log(hasColor('notacolor')); // false

// Get all available color names
const colorNames = Object.keys(colors);
console.log(`Total colors: ${colorNames.length}`); // 148

Capabilities

Color Data Mapping

The package exports a single object containing all CSS named colors as defined by the W3C CSS color specifications.

/**
 * Object mapping CSS color names to RGB arrays
 * Each property represents a standardized CSS color name
 * Each value is a 3-element array [R, G, B] with values 0-255
 */
const colors: {
  [colorName: string]: [number, number, number];
};

The complete list of 148 available colors includes:

Primary Colors:

• red: [255, 0, 0]
• green: [0, 128, 0]
• blue: [0, 0, 255]
• yellow: [255, 255, 0]
• cyan: [0, 255, 255]
• magenta: [255, 0, 255]

Grayscale Colors:

• black: [0, 0, 0]
• white: [255, 255, 255]
• gray: [128, 128, 128] / grey: [128, 128, 128]
• darkgray: [169, 169, 169] / darkgrey: [169, 169, 169]
• lightgray: [211, 211, 211] / lightgrey: [211, 211, 211]
• dimgray: [105, 105, 105] / dimgrey: [105, 105, 105]
• silver: [192, 192, 192]
• gainsboro: [220, 220, 220]
• whitesmoke: [245, 245, 245]

Named Web Colors (alphabetically):

• aliceblue: [240, 248, 255]
• antiquewhite: [250, 235, 215]
• aqua: [0, 255, 255]
• aquamarine: [127, 255, 212]
• azure: [240, 255, 255]
• beige: [245, 245, 220]
• bisque: [255, 228, 196]
• blanchedalmond: [255, 235, 205]
• blueviolet: [138, 43, 226]
• brown: [165, 42, 42]
• burlywood: [222, 184, 135]
• cadetblue: [95, 158, 160]
• chartreuse: [127, 255, 0]
• chocolate: [210, 105, 30]
• coral: [255, 127, 80]
• cornflowerblue: [100, 149, 237]
• cornsilk: [255, 248, 220]
• crimson: [220, 20, 60]
• darkblue: [0, 0, 139]
• darkcyan: [0, 139, 139]
• darkgoldenrod: [184, 134, 11]
• darkgray: [169, 169, 169]
• darkgreen: [0, 100, 0]
• darkkhaki: [189, 183, 107]
• darkmagenta: [139, 0, 139]
• darkolivegreen: [85, 107, 47]
• darkorange: [255, 140, 0]
• darkorchid: [153, 50, 204]
• darkred: [139, 0, 0]
• darksalmon: [233, 150, 122]
• darkseagreen: [143, 188, 143]
• darkslateblue: [72, 61, 139]
• darkslategray: [47, 79, 79]
• darkslategrey: [47, 79, 79]
• darkturquoise: [0, 206, 209]
• darkviolet: [148, 0, 211]
• deeppink: [255, 20, 147]
• deepskyblue: [0, 191, 255]
• dimgray: [105, 105, 105]
• dodgerblue: [30, 144, 255]
• firebrick: [178, 34, 34]
• floralwhite: [255, 250, 240]
• forestgreen: [34, 139, 34]
• fuchsia: [255, 0, 255]
• ghostwhite: [248, 248, 255]
• gold: [255, 215, 0]
• goldenrod: [218, 165, 32]
• gray: [128, 128, 128]
• greenyellow: [173, 255, 47]
• honeydew: [240, 255, 240]
• hotpink: [255, 105, 180]
• indianred: [205, 92, 92]
• indigo: [75, 0, 130]
• ivory: [255, 255, 240]
• khaki: [240, 230, 140]
• lavender: [230, 230, 250]
• lavenderblush: [255, 240, 245]
• lawngreen: [124, 252, 0]
• lemonchiffon: [255, 250, 205]
• lightblue: [173, 216, 230]
• lightcoral: [240, 128, 128]
• lightcyan: [224, 255, 255]
• lightgoldenrodyellow: [250, 250, 210]
• lightgray: [211, 211, 211]
• lightgreen: [144, 238, 144]
• lightpink: [255, 182, 193]
• lightsalmon: [255, 160, 122]
• lightseagreen: [32, 178, 170]
• lightskyblue: [135, 206, 250]
• lightslategray: [119, 136, 153]
• lightslategrey: [119, 136, 153]
• lightsteelblue: [176, 196, 222]
• lightyellow: [255, 255, 224]
• lime: [0, 255, 0]
• limegreen: [50, 205, 50]
• linen: [250, 240, 230]
• maroon: [128, 0, 0]
• mediumaquamarine: [102, 205, 170]
• mediumblue: [0, 0, 205]
• mediumorchid: [186, 85, 211]
• mediumpurple: [147, 112, 219]
• mediumseagreen: [60, 179, 113]
• mediumslateblue: [123, 104, 238]
• mediumspringgreen: [0, 250, 154]
• mediumturquoise: [72, 209, 204]
• mediumvioletred: [199, 21, 133]
• midnightblue: [25, 25, 112]
• mintcream: [245, 255, 250]
• mistyrose: [255, 228, 225]
• moccasin: [255, 228, 181]
• navajowhite: [255, 222, 173]
• navy: [0, 0, 128]
• oldlace: [253, 245, 230]
• olive: [128, 128, 0]
• olivedrab: [107, 142, 35]
• orange: [255, 165, 0]
• orangered: [255, 69, 0]
• orchid: [218, 112, 214]
• palegoldenrod: [238, 232, 170]
• palegreen: [152, 251, 152]
• paleturquoise: [175, 238, 238]
• palevioletred: [219, 112, 147]
• papayawhip: [255, 239, 213]
• peachpuff: [255, 218, 185]
• peru: [205, 133, 63]
• pink: [255, 192, 203]
• plum: [221, 160, 221]
• powderblue: [176, 224, 230]
• purple: [128, 0, 128]
• rebeccapurple: [102, 51, 153]
• rosybrown: [188, 143, 143]
• royalblue: [65, 105, 225]
• saddlebrown: [139, 69, 19]
• salmon: [250, 128, 114]
• sandybrown: [244, 164, 96]
• seagreen: [46, 139, 87]
• seashell: [255, 245, 238]
• sienna: [160, 82, 45]
• skyblue: [135, 206, 235]
• slateblue: [106, 90, 205]
• slategray: [112, 128, 144]
• slategrey: [112, 128, 144]
• snow: [255, 250, 250]
• springgreen: [0, 255, 127]
• steelblue: [70, 130, 180]
• tan: [210, 180, 140]
• teal: [0, 128, 128]
• thistle: [216, 191, 216]
• tomato: [255, 99, 71]
• turquoise: [64, 224, 208]
• violet: [238, 130, 238]
• wheat: [245, 222, 179]
• yellowgreen: [154, 205, 50]

Data Format

Color Name Format

• All color names are lowercase strings
• No spaces or special characters
• Some colors have both "gray" and "grey" spellings (e.g., darkgray and darkgrey)

RGB Array Format

Each color value is represented as a 3-element array:

type RGBArray = [number, number, number];

Where:

• First element is the Red component (0-255)
• Second element is the Green component (0-255)
• Third element is the Blue component (0-255)

Error Handling

The package provides no error handling since it only exports static data. Accessing non-existent color names returns undefined:

const colors = require('color-name');

console.log(colors.red);        // [255, 0, 0]
console.log(colors.notacolor);  // undefined

Standards Compliance

All color names and values are based on the W3C CSS Color Module Level 3 specification, ensuring compatibility with web standards and CSS implementations.