HTML Builder

A design reference and helper tool for web development. Quickly look up color palettes, font pairings, layout grids, icon libraries, spacing scales, responsive breakpoints, contrast checkers, shadow presets, mockup tools, and design checklists — all from your terminal.

Commands

Data Storage

• Data directory: ~/.local/share/html-builder/ (override with $HTML_BUILDER_DIR or $XDG_DATA_HOME)
• History log: $DATA_DIR/history.log — records every command invocation with timestamp
• All data is stored locally; no external services or accounts required

Requirements

• Bash 4+ (uses set -euo pipefail)
• No external dependencies — pure bash, no API keys needed
• Works on Linux and macOS

When to Use

1. Starting a new web project — quickly reference standard color palettes, font pairings, and grid layouts without leaving the terminal
2. Checking responsive design — look up breakpoint values (sm/md/lg/xl/2xl) to ensure your CSS media queries follow common conventions
3. Reviewing accessibility — use the contrast command to get the WCAG contrast checker link and the checklist command for a quick design audit
4. Prototyping UI components — reference spacing scales and shadow presets to maintain consistent visual rhythm across your design
5. Onboarding a new designer or developer — share the tool as a quick-reference cheat sheet for design system fundamentals

Examples

# Get the default color palette
html-builder palette

# Look up recommended heading and body font pairings
html-builder font

# Check responsive breakpoint values for CSS media queries
html-builder breakpoint

# Get box-shadow CSS presets (small, medium, large)
html-builder shadow

# Run through the design checklist before shipping
html-builder checklist

Example Output

$ html-builder spacing
  xs:4 sm:8 md:16 lg:24 xl:32 2xl:48