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, orexport.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
Powered by BytesAgain | bytesagain.com | hello@bytesagain.com