draw

# 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 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 ```bash # 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: ```bash draw stats > design-report.txt draw export csv ``` --- *Powered by BytesAgain | bytesagain.com | hello@bytesagain.com*