🎨 ColorPal

A powerful CLI tool for color palette extraction and manipulation.

Installation

npm install -g @mazhu/colorpal

Features

• 🖼️ Extract colors from images
• 🔄 Convert between color formats (HEX, RGB, HSL, CMYK)
• 🎨 Generate color palettes (complementary, analogous, triadic, etc.)
• 📊 Check WCAG contrast ratios for accessibility
• 🎲 Generate random colors
• 🌈 Create color gradients

Usage

Extract colors from image

colorpal extract image.jpg
colorpal extract image.png -c 8 -q 3

Convert color formats

colorpal convert #ff0000
colorpal convert rgb(255, 128, 0)
colorpal convert hsl(120, 50%, 50%)

Generate color palettes

colorpal palette #3498db
colorpal palette #e74c3c -t complementary
colorpal palette #9b59b6 -t analogous

Palette types:

• complementary - Opposite colors on color wheel
• analogous - Adjacent colors
• triadic - Evenly spaced three colors
• tetradic - Four colors forming rectangle
• split-complementary - Base + two adjacent to complement
• monochromatic - Variations of single hue

Check contrast ratio

colorpal contrast #ffffff #000000
colorpal contrast #333333 #ffffff

Generate random colors

colorpal random
colorpal random -c 10

Create gradients

colorpal gradient #ff0000 #0000ff
colorpal gradient #ff0000 #0000ff -s 20

Examples

# Extract 8 colors from a photo
colorpal extract photo.jpg -c 8

# Get complementary palette for a brand color
colorpal palette #ff6b6b -t complementary

# Check if text is accessible
colorpal contrast #333333 #ffffff

# Create a 20-step gradient
colorpal gradient #ff9a9e #fecfef -s 20

License

MIT © Mike Wang