bubbles-color

README

bubbles-color

A beautiful terminal color picker built with Bubble Tea.

Screenshots

TrueColor Mode

Theme Mode

History Mode

Features

• HSL sliders for intuitive color adjustment
• RGB/HEX input fields with real-time preview
• Multiple color palette modes:
  • TrueColor - Smooth HSL gradient (24-bit)
  • 256 - Terminal 256 colors
  • Basic - 16 ANSI colors
  • Grayscale - Grayscale palette
  • Solarized - Solarized theme
  • Dracula - Dracula theme
  • Nord - Nord theme
  • Gruvbox - Gruvbox theme
  • Monokai - Monokai theme
  • Catppuccin - Catppuccin Mocha theme
  • Tokyo Night - Tokyo Night theme
  • Tailwind - Tailwind CSS colors
  • Material - Material Design colors
  • History - Recently used colors
• Auto-detects terminal color support
• Responsive layout adapts to terminal size
• Color history with persistent storage

Installation

go install github.com/mritd/bubbles-color@latest

Or build from source:

git clone https://github.com/mritd/bubbles-color.git
cd bubbles-color
task build
./dist/bubbles-color

Usage

bubbles-color

Development

This project uses Task for build automation:

task          # Build for current platform
task test     # Run unit tests
task lint     # Run linter
task fmt      # Format code
task release  # Build all release binaries

Keyboard Shortcuts

Key	Action
Tab	Switch between left panel and palette
Arrow Keys	Navigate sliders/inputs or palette
Enter	Apply input value
[ / ]	Switch palette mode
h	Jump to history
Esc	Switch to palette / Quit
q	Quit

Requirements

• Go 1.25+
• Terminal with color support (TrueColor recommended)

Dependencies

• Bubble Tea - TUI framework
• Bubbles - TUI components
• Lip Gloss - Style definitions
• go-colorful - Color manipulation
• Cobra - CLI framework