Draw

Design toolkit for managing color palettes, generating swatches, mixing colors, creating gradients, previewing designs, and exporting results. A command-line companion for designers and front-end developers.

Commands

Command	Description
`draw palette <input>`	Create or log a color palette entry
`draw preview <input>`	Record a design preview note
`draw generate <input>`	Generate and log a design asset or concept
`draw convert <input>`	Log a color or format conversion
`draw harmonize <input>`	Record a color harmony analysis
`draw contrast <input>`	Log a contrast check result
`draw export <input>`	Log an export operation
`draw random <input>`	Record a random color or design generation
`draw browse <input>`	Log a browsing/discovery session
`draw mix <input>`	Record a color mixing result
`draw gradient <input>`	Log a gradient definition
`draw swatch <input>`	Record a color swatch entry
`draw stats`	Show summary statistics across all logs
`draw export <fmt>`	Export all data (json, csv, or txt)
`draw search <term>`	Search across all log files for a term
`draw recent`	Show the 20 most recent activity entries
`draw status`	Health check — version, disk usage, last activity
`draw help`	Show all available commands
`draw version`	Show current version

Each command without arguments displays the most recent 20 entries from its log file.

Data Storage

All data is stored in ~/.local/share/draw/:

Per-command logs — palette.log, preview.log, generate.log, convert.log, harmonize.log, contrast.log, export.log, random.log, browse.log, mix.log, gradient.log, swatch.log
Activity history — history.log (unified timeline of all actions)
Exports — export.json, export.csv, or export.txt (generated on demand)

Data format: each entry is stored as YYYY-MM-DD HH:MM|<value>, pipe-delimited for easy parsing.

Requirements

Bash 4+ with set -euo pipefail
Standard POSIX utilities (date, wc, du, head, tail, grep, cut, basename)
No external dependencies or API keys required

When to Use

Building a color system — log palettes, harmonies, and contrast checks while designing a brand or UI theme
Prototyping design assets — generate swatches, gradients, and random color explorations for rapid iteration
Auditing accessibility — record contrast ratios and color harmony data for WCAG compliance reviews
Maintaining a design journal — track every color decision, mix experiment, and conversion over time
Exporting design data — export your full color and design history as JSON, CSV, or plain text for handoff to other tools

Examples

# Log a new palette
draw palette "#FF5733 #33FF57 #3357FF warm-sunset"

# Record a contrast check
draw contrast "bg:#FFFFFF fg:#333333 ratio:12.6:1 PASS"

# Mix two colors and log the result
draw mix "#FF0000 + #0000FF = #800080 purple"

# Generate a gradient definition
draw gradient "linear 90deg #000000 → #FFFFFF"

# Create a swatch entry
draw swatch "Coral #FF7F50 used in header CTA"

# Export all design data as JSON
draw export json

# Search all logs for a specific hex color
draw search "FF5733"

# View recent activity
draw recent

# Check overall status
draw status

Output

All command output goes to stdout. Redirect to a file if needed:

draw stats > design-report.txt
draw export csv