lucide-icons

Lucide Icons Skill

Search, download, and customize Lucide icons (1000+ beautiful SVG icons).

Quick Start

# Search for icons
node ./scripts/lucide.js search heart

# Download an icon
node ./scripts/lucide.js download heart --output ./icons/

# Download with React component
node ./scripts/lucide.js download heart --output ./icons/ --format svg,react

# Customize icon
node ./scripts/lucide.js download star --color "#ffd700" --size 32

Commands

search <keyword>

Search for icons by name or keyword.

lucide search heart --limit 10

download <icon-name>

Download a single icon with optional customization.

Options:

• -o, --output <dir> - Output directory (default: current directory)
• -f, --format <formats> - Output formats: svg, react (default: svg)
• -c, --color <color> - Icon color (default: currentColor)
• -s, --size <size> - Icon size in pixels (default: 24)
• -w, --stroke-width <width> - Stroke width (default: 2)
• --overwrite - Overwrite existing files

list

List all available icons.

lucide list --limit 50

info <icon-name>

Show detailed information about an icon.

lucide info heart

refresh

Refresh the icon metadata cache.

lucide refresh

Installation

Before first use, install dependencies:

cd ./scripts && npm install

Output Formats

SVG

Standard SVG file with optional customization (color, size, stroke-width).

React (TypeScript)

Generates a fully-typed React component with props:

• size - Icon size
• color - Icon color
• strokeWidth - Stroke width
• className - CSS classes
• style - Inline styles
• aria-label - Accessibility label

Examples

# Download heart icon to src/icons/
lucide download heart -o ./src/icons/

# Download with custom color and size
lucide download star --color "#ffd700" --size 32 -o ./icons/

# Generate both SVG and React component
lucide download check-circle --format svg,react -o ./src/components/icons/

# Search for arrow icons
lucide search arrow --limit 20

Data Source

Icons are fetched from the official Lucide repository.

More Information

See README.md for detailed documentation.