ConfigsApr 11, 2026·2 min read

Lucide — Beautiful & Consistent Icon Toolkit

Lucide is a beautiful and consistent icon toolkit made by the community — a fork of Feather Icons with 1500+ crisp, minimalist SVG icons. First-class React, Vue, Svelte, Solid, Angular, and Web Component libraries.

TL;DR
Lucide provides 1500+ crisp SVG icons with first-class React, Vue, Svelte, and Angular components.
§01

What it is

Lucide is an open-source icon toolkit with over 1500 crisp, minimalist SVG icons. It is a community-driven fork of Feather Icons with significantly more icons and active maintenance. Lucide provides first-class components for React, Vue, Svelte, Solid, Angular, and Web Components, plus a static SVG sprite option.

Lucide is for frontend developers and designers who need a consistent, tree-shakeable icon set that works across all major web frameworks.

The project is actively maintained with regular releases and a growing user community. Documentation covers common use cases, and the open-source nature means you can inspect the source code, contribute fixes, and adapt the tool to your specific requirements.

§02

How it saves time or tokens

Searching for individual icons from multiple sources leads to inconsistent sizes, stroke widths, and design language. Lucide provides a single, cohesive set where every icon shares the same 24x24 grid, 2px stroke width, and design principles. Tree-shaking ensures only the icons you import are included in your bundle.

§03

How to use

  1. Install the Lucide package for your framework.
  2. Import individual icons by name.
  3. Use them as components with optional size, color, and stroke-width props.
§04

Example

// React
import { Home, User, Settings, Search } from 'lucide-react';

export function NavBar() {
  return (
    <nav>
      <Home size={20} />
      <Search size={20} />
      <User size={20} />
      <Settings size={20} strokeWidth={1.5} />
    </nav>
  );
}
# Install for your framework
npm install lucide-react     # React
npm install lucide-vue-next  # Vue 3
npm install @lucide/svelte   # Svelte
§05

Related on TokRepo

§06

Common pitfalls

  • Importing the entire lucide-react package instead of individual icons defeats tree-shaking and inflates your bundle size. Always use named imports.
  • Lucide icons default to 24x24. Scaling them to very small sizes (below 16px) can make the 2px stroke appear too thick. Reduce strokeWidth proportionally.
  • The Lucide Vue package has different import paths for Vue 2 (lucide-vue) and Vue 3 (lucide-vue-next). Using the wrong package causes runtime errors.

Before adopting this tool, evaluate whether it fits your team's existing workflow. Read the official documentation thoroughly, and start with a small proof-of-concept rather than a full migration. Community forums, GitHub issues, and Stack Overflow are valuable resources when you encounter edge cases not covered in the documentation.

Frequently Asked Questions

How is Lucide different from Feather Icons?+

Lucide is a fork of Feather Icons with more active development and a larger icon set. Feather Icons has around 280 icons and has not been actively maintained since 2020. Lucide has over 1500 icons with regular additions from the community.

Does Lucide support tree-shaking?+

Yes. Each icon is exported as a named export. When you import only the icons you use, bundlers like Webpack, Vite, and Rollup tree-shake the unused icons out of your production bundle.

Can I customize icon colors and sizes?+

Yes. Lucide components accept size, color, strokeWidth, and className props. Colors default to currentColor, so they inherit from the parent CSS color property. Size and strokeWidth can be set per-icon.

Which frameworks does Lucide support?+

Lucide provides official packages for React, Vue 2, Vue 3, Svelte, Solid, Angular, Preact, and Web Components. A static SVG sprite is also available for non-framework usage.

Is Lucide free for commercial use?+

Yes. Lucide is licensed under the ISC license, which permits commercial use, modification, and redistribution with minimal restrictions.

Citations (3)

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets