PACKAGE · ICONS

lucide-react

A Lucide icon library package for React applications.

WEEKLY DOWNLOADS 110.3M
STARS 24.8K
FORKS 1.6K
OPEN ISSUES 482
GZIP SIZE 194.0 kB
UNPACKED SIZE 35.4 MB
DEPENDENCIES 2
LAST UPDATED 7mo ago
DOWNLOAD TRENDS

lucide-react downloads · last 12 months

Download trends for lucide-react1 download series from Oct 2025 to Sep 2026. Use left and right arrow keys to inspect monthly values.0106.6M213.1M319.7M426.2MOct 2025JanAprJulSep 2026
lucide-react
ABOUT LUCIDE-REACT

Lucide-React provides a comprehensive and highly customizable icon library for React applications, addressing the common need for accessible and scalable vector graphics. It aims to simplify the integration of a vast set of icons, offering a clean and developer-friendly experience for UI design and development.

The core philosophy behind Lucide-React is to offer a performant and flexible solution for icon management. It's designed with React developers in mind, prioritizing ease of use, maintainability, and seamless integration into modern React workflows. The library targets developers and design teams seeking a consistent visual language across their applications.

Key features include a component-based API where each icon is a distinct React component. Developers can import and use these components directly, leveraging props for customization like size, color, and stroke width. The library also supports tree-shaking, ensuring that only the icons actually used in your project are included in the final bundle, which is crucial for optimizing application performance.

Lucide-React integrates smoothly into any React project, regardless of the build tool or state management solution used. Its SVG-based nature makes it compatible with standard web development practices. The library is built with modern JavaScript and React features, fitting naturally into ecosystems using tools like Webpack, Vite, or Create React App.

With weekly downloads exceeding 108.8 million, Lucide-React is a mature and widely adopted icon solution. Its SVG format ensures scalability without loss of quality, and the library's structure is designed to minimize bundle size through efficient rendering. The unpacked size of 35.4 MB is typical for a comprehensive icon set, but its gzipped bundle contribution is optimized to 194.0 kB.

While robust, developers should be aware that the extensive nature of the icon set might lead to larger initial imports if not managed carefully. Proper tree-shaking is essential. For extremely niche use cases requiring dynamic SVG manipulation beyond simple prop changes, direct SVG manipulation might be considered, though Lucide-React covers most common requirements.

WHEN TO USE
  • When implementing a consistent and scalable icon system across a React application.
  • When needing to dynamically change icon size, color, and stroke width using component props.
  • When aiming to optimize bundle size through tree-shaking by importing individual icon components.
  • When integrating with design systems that require a vast library of well-organized SVG icons.
  • When building user interfaces that require clear visual cues and iconography for navigation or actions.
  • When working with Storybook or other component development environments for visual testing and documentation of icons.
  • When seeking an icon library with a strong community presence, indicated by 24.8K GitHub stars and 1.6K forks.
WHEN NOT TO USE
  • If your application exclusively uses inline SVGs or a custom SVG management system that doesn't require external libraries.
  • If you only need a very small, fixed set of icons and prefer to manage them as individual SVG files to minimize dependencies.
  • When building for environments where JavaScript execution is restricted or highly limited, as Lucide-React is a JavaScript library.
  • If you are developing a non-React application, as this package is specifically for React.
  • When a project's sole requirement is for font icons, and migrating to SVG-based icons is not feasible or desired.

CORRECTIONS

Spot wrong data here?

A short note helps us fix it.

Anonymous · No account · No email back

COMPARISONS 3
lucide-react vs @phosphor-icons/react ★ 1.8K · 5.0M/wk lucide-react vs @tabler/icons-react ★ 21.9K · 3.3M/wk lucide-react vs @heroicons/react ★ 23.8K · 4.1M/wk