PACKAGE · ICONS

@phosphor-icons/react

A clean and friendly icon family for React

WEEKLY DOWNLOADS 942.9K
STARS 1.7K
FORKS 83
OPEN ISSUES 19
GZIP SIZE 1.1 MB
UNPACKED SIZE 33.0 MB
LAST UPDATED 1y ago
DOWNLOAD TRENDS

@phosphor-icons/react downloads — last 12 months

Download trends for @phosphor-icons/react1 download series from Jun 2025 to May 2026. Use left and right arrow keys to inspect monthly values.01.9M3.7M5.6M7.4MJun 2025SepDecMarMay 2026
@phosphor-icons/react
ABOUT @PHOSPHOR-ICONS/REACT

Phosphorcons/react provides a comprehensive set of SVG icons designed for seamless integration within React applications. It addresses the common challenge of finding and implementing consistent, scalable, and themable icons across a project. The package offers a large library of distinct icon designs, reducing the need for developers to source or create individual SVG assets.

The core philosophy behind Phosphorcons/react is to offer a clean, friendly, and highly customizable icon system. It caters to front-end developers building modern web interfaces, particularly those who prioritize design consistency and maintainability. The library emphasizes a unified aesthetic, making it suitable for projects aiming for a polished and professional user experience.

The package's API is built around React components. Developers import individual icons as named exports, such as `import { Plus } from '@phosphor-icons/react';`, and render them directly within their JSX. This approach leverages React's declarative nature and component model. Customization is achieved through standard React props like `size`, `color`, and `weight`, allowing for dynamic styling.

Integration with the React ecosystem is straightforward. Phosphorcons/react works out-of-the-box with Create React App, Next.js, Vite, and other common React build tools and frameworks. Its component-based nature makes it compatible with state management solutions and UI composition patterns typical in React development. The SVG nature of the icons ensures they scale perfectly with application layouts.

With a substantial bundle size of 1.1 MB (gzipped), Phosphorcons/react represents a significant addition to an application's JavaScript payload. While this provides a vast icon set, developers should consider this trade-off against the need for numerous icons. The package, last updated in January 2026, indicates a mature and actively maintained project, evidenced by its 1.6K GitHub stars and 802.8K weekly downloads.

A potential consideration is the inclusion of the entire icon set within the bundle, even if only a subset is used. While tree-shaking might mitigate this to some extent, projects with extremely strict bundle size requirements or those only needing a handful of icons might need to evaluate alternatives. The 19 open issues suggest a healthy but not entirely bug-free development cycle.

WHEN TO USE
  • When building a React application requiring a diverse range of modern, consistent SVG icons.
  • When needing to dynamically change icon size, color, and weight via React props like `size`, `color`, and `weight`.
  • When integrating with bundlers like Webpack or Vite that support tree-shaking for potentially optimizing icon imports.
  • When developing projects where a unified and clean icon aesthetic is a key design requirement.
  • When leveraging React's component model for rendering icons directly within JSX elements.
  • When needing icons that scale crisply without pixelation across different screen densities.
WHEN NOT TO USE
  • If your application only requires 1-3 basic icons, a lighter, manually imported SVG approach might yield a smaller bundle.
  • If you are working in a non-React environment and require SVG icons that can be rendered server-side without a React context.
  • If the 1.1 MB (gzipped) bundle size is a critical constraint, and you can achieve your visual goals with a much smaller icon set from a more specialized source.
  • If you prefer to manage icons as a font file for broader compatibility with non-SVG rendering environments.
  • When minimal JavaScript footprint is paramount, consider static SVG assets embedded directly in your HTML or CSS.

CORRECTIONS

Spot wrong data here?

A short note helps us fix it.

Anonymous · No account · No email back

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