Palette — Color Palette Generation & Management Tool#

Generate harmonious color palettes using color theory (complementary, analogous, triadic), create random palettes, preview colors in terminal, export to CSS/JSON/SVG, and manage a library of saved palettes. Essential for designers, frontend developers, and anyone working with color systems.

Prerequisites#

• Python 3.8+
• bash shell
• Terminal with ANSI color support (for previews)

Data Storage#

All palette data is stored in ~/.palette/data.jsonl as newline-delimited JSON. Each record contains palette name, colors (hex values), color theory type, and metadata.

Configuration is stored in ~/.palette/config.json.

Commands#

create#

Create a new named palette from a list of hex color values.

text

PALETTE_NAME="ocean-breeze" PALETTE_COLORS="#0077B6,#00B4D8,#90E0EF,#CAF0F8,#023E8A" bash scripts/script.sh create

random#

Generate a random palette with a specified number of colors (default: 5). Optionally constrain by hue range or saturation.

text

PALETTE_COUNT=5 PALETTE_HUE_MIN=180 PALETTE_HUE_MAX=270 bash scripts/script.sh random

complementary#

Generate a complementary color palette from a base color. Returns the base color and its complement with optional shades.

text

PALETTE_BASE="#FF6B35" PALETTE_SHADES=3 bash scripts/script.sh complementary

analogous#

Generate an analogous color palette from a base color. Returns colors adjacent on the color wheel (±30°).

text

PALETTE_BASE="#2EC4B6" PALETTE_COUNT=5 bash scripts/script.sh analogous

triadic#

Generate a triadic color palette from a base color. Returns three colors equally spaced (120°) on the color wheel.

text

PALETTE_BASE="#E71D36" PALETTE_SHADES=2 bash scripts/script.sh triadic

export#

Export a palette to various formats: CSS custom properties, JSON, SVG swatches, Tailwind config, or SCSS variables.

text

PALETTE_ID=<id> PALETTE_FORMAT=css PALETTE_OUTPUT=./colors.css bash scripts/script.sh export

preview#

Display a palette in the terminal using ANSI color blocks. Shows hex values, RGB, and HSL alongside color swatches.

text

PALETTE_ID=<id> bash scripts/script.sh preview

list#

List all saved palettes with their names, color counts, and creation dates.

text

bash scripts/script.sh list

save#

Save/bookmark the most recently generated palette with a name and optional tags for organization.

text

PALETTE_NAME="sunset-vibes" PALETTE_TAGS="warm,sunset,gradient" bash scripts/script.sh save

config#

View or update configuration (default color count, preferred format, terminal color mode).

text

PALETTE_KEY=default_count PALETTE_VALUE=7 bash scripts/script.sh config

help#

Show usage information and available commands.

text

bash scripts/script.sh help

version#

Display the current version of the palette skill.

text

bash scripts/script.sh version

Examples#

bash

# Generate a triadic palette from a brand color
PALETTE_BASE="#6C63FF" bash scripts/script.sh triadic

# Save it with a name
PALETTE_NAME="brand-triadic" bash scripts/script.sh save

# Preview in terminal
PALETTE_ID=<id> bash scripts/script.sh preview

# Export as CSS custom properties
PALETTE_ID=<id> PALETTE_FORMAT=css PALETTE_OUTPUT=./brand-colors.css bash scripts/script.sh export

Color Theory Quick Reference#

• Complementary: Opposite on the color wheel (high contrast)
• Analogous: Adjacent colors (harmonious, low contrast)
• Triadic: Three equidistant colors (vibrant, balanced)
• Random: Algorithmically generated with optional constraints

Notes#

• Colors are stored and processed as hex values internally, converted to RGB/HSL as needed.
• Terminal preview requires a terminal that supports 24-bit (truecolor) ANSI codes.
• Export formats include CSS, JSON, SVG, SCSS, and Tailwind — easily extensible.

---

Powered by BytesAgain | bytesagain.com | hello@bytesagain.com