---
name: lucide-laravel
description: Lucide icon library integration for Laravel Blade templates. Use when working with Lucide icons in Laravel applications, Blade components with the x-lucide- prefix, icon styling with Tailwind CSS, dynamic icon rendering in Blade, or any Laravel view work requiring SVG icons. Keywords include lucide icons, blade icons, x-lucide, SVG icons Laravel, blade-lucide-icons, mallardduck/blade-lucide-icons.
---
# Lucide Laravel
Laravel Blade integration for the [Lucide](https://lucide.dev) icon library - 1,666+ beautiful, consistent SVG icons.
## Installation
```bash
composer require mallardduck/blade-lucide-icons
```
Clear view cache if icons don't appear:
```bash
php artisan view:clear
```
## Quick Start
### Basic Usage
Icons use the `x-lucide-` prefix with kebab-case naming:
```blade
```
### Naming Convention
Convert PascalCase icon names to kebab-case:
| Icon Name | Blade Component |
|-----------|----------------|
| Activity | `` |
| ShoppingCart | `` |
| CircleCheck | `` |
| ArrowRight | `` |
## Styling
### Tailwind CSS
```blade
```
### Inline Styles
```blade
```
## Common Patterns
### Navigation Menus
```blade
```
### Form Inputs
```blade
```
### Alerts
```blade
Success!
Your changes have been saved.
Error
Something went wrong.
Please review your changes before submitting.
```
### Action Buttons
```blade
```
### With Livewire
```blade
@if($isFavorited)
@else
@endif
```
## Dynamic Icons
Use `` for dynamic icon names:
```blade
@php
$iconName = 'heart';
$iconComponent = 'lucide-' . $iconName;
@endphp
```
Common use case - icon from database:
```blade
```
## Best Practices
### Consistent Sizing
| Context | Size |
|---------|------|
| Navigation | `w-5 h-5` |
| Button (small) | `w-4 h-4` |
| Button (medium) | `w-5 h-5` |
| Feature icons | `w-12 h-12` |
| Hero icons | `w-16 h-16` |
### Semantic Icon Usage
Choose icons that clearly represent their action:
```blade
```
### Color Semantics
```blade
```
### Accessibility
```blade
```
## Icon Reference
**Total Icons:** 1,666 across 43 categories
### Quick Reference
| Category | Count | File | Common Icons |
|----------|-------|------|--------------|
| Accessibility | 30 | [accessibility.md](references/categories/accessibility.md) | `accessibility`, `eye`, `ear`, `glasses`, `sun`, `moon` |
| Accounts & access | 133 | [accounts-access.md](references/categories/accounts-access.md) | `user`, `users`, `shield`, `key`, `lock`, `log-in`, `log-out` |
| Animals | 23 | [animals.md](references/categories/animals.md) | `dog`, `cat`, `bird`, `bug`, `fish`, `paw-print` |
| Arrows | 209 | [arrows.md](references/categories/arrows.md) | `arrow-up`, `arrow-down`, `chevron-left`, `chevron-right` |
| Brands | 21 | [brands.md](references/categories/brands.md) | `github`, `twitter`, `facebook`, `instagram`, `youtube` |
| Buildings | 25 | [buildings.md](references/categories/buildings.md) | `building`, `building-2`, `home`, `warehouse`, `store` |
| Charts | 31 | [charts.md](references/categories/charts.md) | `bar-chart`, `line-chart`, `pie-chart`, `trending-up`, `trending-down` |
| Coding & development | 243 | [coding-development.md](references/categories/coding-development.md) | `code`, `terminal`, `git-branch`, `git-commit`, `bug`, `cpu` |
| Communication | 54 | [communication.md](references/categories/communication.md) | `mail`, `message-circle`, `phone`, `send`, `bell`, `rss` |
| Connectivity | 90 | [connectivity.md](references/categories/connectivity.md) | `wifi`, `bluetooth`, `usb`, `cast`, `radio`, `signal` |
| Cursors | 33 | [cursors.md](references/categories/cursors.md) | `mouse-pointer`, `hand`, `move`, `crosshair`, `pointer` |
| Design | 145 | [design.md](references/categories/design.md) | `palette`, `paintbrush`, `eraser`, `pen-tool`, `selection` |
| Devices | 164 | [devices.md](references/categories/devices.md) | `laptop`, `monitor`, `smartphone`, `tablet`, `keyboard`, `hard-drive` |
| Emoji | 28 | [emoji.md](references/categories/emoji.md) | `smile`, `frown`, `meh`, `heart`, `thumbs-up`, `thumbs-down` |
| File icons | 162 | [file-icons.md](references/categories/file-icons.md) | `file`, `file-text`, `folder`, `upload`, `download`, `copy` |
| Finance | 56 | [finance.md](references/categories/finance.md) | `dollar-sign`, `credit-card`, `wallet`, `banknote`, `coins`, `piggy-bank` |
| Food & beverage | 69 | [food-beverage.md](references/categories/food-beverage.md) | `coffee`, `utensils`, `pizza`, `burger`, `beer`, `cake` |
| Gaming | 148 | [gaming.md](references/categories/gaming.md) | `gamepad`, `gamepad-2`, `trophy`, `dice`, `puzzle`, `sword` |
| Home | 57 | [home.md](references/categories/home.md) | `couch`, `chair`, `bed`, `lamp`, `tv`, `bathtub` |
| Layout | 139 | [layout.md](references/categories/layout.md) | `layout`, `panel-left`, `panel-right`, `columns`, `sidebar`, `grid` |
| Mail | 26 | [mail.md](references/categories/mail.md) | `mail`, `inbox`, `send`, `at-sign`, `mail-open`, `mail-check` |
| Mathematics | 74 | [mathematics.md](references/categories/mathematics.md) | `equal`, `plus`, `minus`, `divide`, `percent`, `infinity` |
| Medical | 42 | [medical.md](references/categories/medical.md) | `heart-pulse`, `activity`, `pill`, `syringe`, `stethoscope`, `bone` |
| Multimedia | 138 | [multimedia.md](references/categories/multimedia.md) | `play`, `pause`, `volume`, `music`, `image`, `video` |
| Nature | 23 | [nature.md](references/categories/nature.md) | `tree`, `flower`, `leaf`, `sun`, `cloud`, `mountain` |
| Navigation, Maps, POIs | 84 | [navigation-maps-pois.md](references/categories/navigation-maps-pois.md) | `map`, `map-pin`, `compass`, `navigation`, `route`, `flag` |
| Notification | 39 | [notification.md](references/categories/notification.md) | `bell`, `bell-ring`, `alert-circle`, `alert-triangle`, `info` |
| People | 3 | [people.md](references/categories/people.md) | `user`, `users`, `user-plus` |
| Photography | 75 | [photography.md](references/categories/photography.md) | `camera`, `image`, `aperture`, `shutter`, `lens`, `film` |
| Science | 32 | [science.md](references/categories/science.md) | `flask`, `microscope`, `atom`, `beaker`, `magnet`, `dna` |
| Seasons | 5 | [seasons.md](references/categories/seasons.md) | `sun`, `cloud-rain`, `snowflake`, `thermometer` |
| Security | 55 | [security.md](references/categories/security.md) | `shield`, `lock`, `unlock`, `key`, `fingerprint`, `eye-off` |
| Shapes | 48 | [shapes.md](references/categories/shapes.md) | `circle`, `square`, `triangle`, `star`, `hexagon`, `diamond` |
| Shopping | 27 | [shopping.md](references/categories/shopping.md) | `shopping-cart`, `shopping-bag`, `credit-card`, `tag`, `package` |
| Social | 119 | [social.md](references/categories/social.md) | `heart`, `thumbs-up`, `share`, `bookmark`, `user-plus`, `link` |
| Sports | 13 | [sports.md](references/categories/sports.md) | `football`, `basketball`, `tennis`, `golf`, `trophy`, `medal` |
| Sustainability | 24 | [sustainability.md](references/categories/sustainability.md) | `recycle`, `leaf`, `tree`, `sun`, `wind`, `droplet` |
| Text formatting | 246 | [text-formatting.md](references/categories/text-formatting.md) | `bold`, `italic`, `underline`, `align-left`, `list`, `quote` |
| Time & calendar | 58 | [time-calendar.md](references/categories/time-calendar.md) | `calendar`, `clock`, `timer`, `hourglass`, `watch`, `alarm` |
| Tools | 66 | [tools.md](references/categories/tools.md) | `hammer`, `wrench`, `screwdriver`, `saw`, `drill`, `measure` |
| Transportation | 64 | [transportation.md](references/categories/transportation.md) | `car`, `bus`, `train`, `plane`, `bike`, `ship` |
| Travel | 67 | [travel.md](references/categories/travel.md) | `suitcase`, `plane`, `hotel`, `map`, `compass`, `passport` |
| Weather | 45 | [weather.md](references/categories/weather.md) | `sun`, `cloud`, `cloud-rain`, `snowflake`, `lightning`, `wind` |
### Finding Icons
1. **Browse by category:** Read the category reference files for complete icon lists
2. **Search visually:** Visit [lucide.dev/icons](https://lucide.dev/icons/)
3. **Use autocomplete:** IDEs with Blade autocomplete can suggest available icons
### Category File Format
Each category file contains:
- Icon count and description
- Complete table of icons with Blade component syntax
- Related categories for each icon
- Usage examples specific to that category
## Troubleshooting
**Icons not displaying:**
```bash
php artisan view:clear
```
**Styling not applied:**
- Ensure Tailwind processes Blade files
- Check icon names use kebab-case
**Publish raw SVGs (optional):**
```bash
php artisan vendor:publish --tag=blade-lucide-icons --force
```