Gradient

Generate CSS gradient code, preview gradient combinations, and build gradient palettes using bash and Python. Use when creating linear, radial, or conic gradients for web design.

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 palette command 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 | [e-mail]