Gradient — CSS Gradient Generator & Palette Builder
Generate production-ready CSS gradient code for linear, radial, and conic gradients. Create gradient palettes, preview combinations, adjust angles and color stops, and export gradient collections. All gradient definitions are stored locally in JSONL format for reuse and sharing.
Prerequisites
- Python 3.6+
- Bash 4+
Data Storage
All gradient records and palettes are stored in ~/.gradient/data.jsonl. Each record is a JSON object with fields including id, name, type (linear, radial, conic), css, stops, angle, created_at, and additional metadata.
Commands
Run via: bash scripts/script.sh <command> [options]
| Command | Description |
|---|---|
create | Create a new gradient with type, colors, angle, and optional name |
list | List all saved gradients with names, types, and CSS preview |
get | Get full details and CSS code for a specific gradient by ID or name |
update | Update an existing gradient's colors, angle, or name |
delete | Remove a gradient from the collection by ID |
linear | Shortcut to generate a linear gradient with angle and color stops |
radial | Shortcut to generate a radial gradient with shape, position, and stops |
conic | Shortcut to generate a conic gradient with start angle and stops |
random | Generate random gradients with optional constraints on hue or type |
palette | Generate a collection of related gradients from a base color |
export | Export gradients as CSS classes, Tailwind config, or SCSS variables |
preview | Generate an HTML preview page for one or all gradients |
help | Show usage information |
version | Print the tool version |
Usage Examples
# Create a simple linear gradient
bash scripts/script.sh create --name sunset --type linear --angle 135 --stops "#ff6b6b,#feca57,#48dbfb"
# Shortcut for linear gradient
bash scripts/script.sh linear --angle 90 --stops "#667eea,#764ba2"
# Create a radial gradient
bash scripts/script.sh radial --shape circle --position center --stops "#00d2ff,#3a7bd5"
# Create a conic gradient
bash scripts/script.sh conic --from 0 --stops "#ff0000,#00ff00,#0000ff,#ff0000"
# List all saved gradients
bash scripts/script.sh list
# Get details for a gradient
bash scripts/script.sh get --id abc123
# Update a gradient
bash scripts/script.sh update --id abc123 --angle 180 --stops "#e74c3c,#9b59b6"
# Delete a gradient
bash scripts/script.sh delete --id abc123
# Generate 5 random gradients
bash scripts/script.sh random --count 5
# Generate gradients with warm hues only
bash scripts/script.sh random --count 3 --hue 0-60
# Build a palette from a base color
bash scripts/script.sh palette --color "#3498db" --count 5
# Export as CSS
bash scripts/script.sh export --format css --output gradients.css
# Export as Tailwind config
bash scripts/script.sh export --format tailwind --output tailwind-gradients.js
# Generate HTML preview
bash scripts/script.sh preview --output preview.html
Output Format
create, linear, radial, and conic output the CSS gradient string to stdout. list returns a formatted table. get returns full JSON metadata. export writes to the specified file format. preview generates a self-contained HTML file.
Notes
- Gradient types:
linear,radial,conic. - Linear gradients support angles in degrees (0-360) or keywords (
to right,to bottom left). - Radial gradients support shapes:
circle,ellipse; positions:center,top left, etc. - Color stops accept hex (
#rrggbb),rgb(),hsl(), or CSS named colors. - Each stop can include an optional position percentage:
#ff0000:30%. - The
palettecommand generates harmonious gradient variations from a single base color. - Export formats:
css(classes),tailwind(JS config),scss(variables with mixins). - Preview HTML includes responsive cards showing each gradient with its CSS code.
Powered by BytesAgain | bytesagain.com | hello@bytesagain.com