PACKAGE · ICONS

@heroicons/react

<p align="center"> <a href="https://heroicons.com" target="_blank"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/tailwindlabs/heroicons/HEAD/.github/logo-dark.svg"> <source media="(pref

WEEKLY DOWNLOADS 1.7M
STARS 23.6K
FORKS 1.3K
OPEN ISSUES 3
GZIP SIZE 224 B
UNPACKED SIZE 3.7 MB
DEPENDENCIES 1
LAST UPDATED 5mo ago
DOWNLOAD TRENDS

@heroicons/react downloads — last 12 months

Download trends for @heroicons/react1 download series from Jun 2025 to May 2026. Use left and right arrow keys to inspect monthly values.04.3M8.6M12.9M17.2MJun 2025SepDecMarMay 2026
@heroicons/react
ABOUT @HEROICONS/REACT

Heroicons for React provides a comprehensive set of MIT-licensed SVG icons specifically designed for React applications. It addresses the common need for consistent, high-quality visual elements within user interfaces, allowing developers to easily integrate a recognizable icon library without the overhead of manual SVG management or complex icon systems.

Developed by the team behind Tailwind CSS, the library adheres to a clean, minimalist design philosophy, making it ideal for modern web development projects that prioritize aesthetics and user experience. The primary audience consists of React developers seeking readily available, well-crafted icons that align with contemporary design trends.

The package exposes icons as individual React components, such as `<AcademicCapIcon />` or `<BeakerIcon />`. These components can be imported and used directly within your JSX, offering props for customization like `className`, `aria-hidden`, and `fill` to control styling and accessibility, ensuring seamless integration into your component tree.

Heroicons for React integrates effortlessly into any React project, including those utilizing frameworks like Next.js or Create React App. Its component-based nature means it works naturally with various build tools and bundlers, and it aligns well with component-driven development workflows and design systems.

With a lean bundle size of 224 B (gzip) per icon, Heroicons prioritizes performance. This small footprint ensures that adding icons does not significantly impact application load times, making it a performant choice for projects of all sizes. The library is mature and actively maintained, as indicated by its considerable GitHub stars and forks.

A potential consideration is that while Heroicons offers a good range of icons, it may not cover every niche use case. For highly specialized or custom icon requirements, developers might need to supplement this library or create their own SVG components.

WHEN TO USE
  • When building user interfaces with React and requiring a consistent set of clean, modern SVG icons.
  • When you need to import icons as individual React components, like `<StarIcon />`, for easy integration into your JSX.
  • When customizing icon appearance via props such as `className` or `fill` to match your application's theme.
  • When integrating with Tailwind CSS projects, leveraging the design synergy between the two libraries.
  • When optimizing for performance and minimizing bundle size, as each icon component is very small.
  • When adhering to accessibility standards by utilizing the `aria-hidden` prop for decorative icons.
WHEN NOT TO USE
  • If your application requires a vast library of highly specialized or obscure icons beyond the scope of Heroicons' offerings.
  • If you are working in a non-React environment and need SVG icons, a different approach for managing SVG assets would be necessary.
  • If you require animated icons, as Heroicons primarily focuses on static SVG rendering.
  • If you are developing a project where SVG manipulation is a core feature, and a more robust SVG library is needed for complex transformations.
  • If the specific visual style of Heroicons does not align with your project's unique design language, opting for a library with a different aesthetic may be preferable.

CORRECTIONS

Spot wrong data here?

A short note helps us fix it.

Anonymous · No account · No email back

COMPARISONS 3
@heroicons/react vs @tabler/icons-react ★ 20.9K · 1.2M/wk @heroicons/react vs @phosphor-icons/react ★ 1.7K · 942.9K/wk @heroicons/react vs lucide-react ★ 22.9K · 44.8M/wk