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

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|, 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

1. Building a color system — log palettes, harmonies, and contrast checks while designing a brand or UI theme
2. Prototyping design assets — generate swatches, gradients, and random color explorations for rapid iteration
3. Auditing accessibility — record contrast ratios and color harmony data for WCAG compliance reviews
4. Maintaining a design journal — track every color decision, mix experiment, and conversion over time
5. 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

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