Heroicons is a free, MIT-licensed set of high-quality SVG icons designed for UI development. You can copy and inline the SVGs directly into HTML, or use the provided React (@heroicons/react) and Vue (@heroicons/vue) packages to import icons as components.
Project status
- Maintenance and status: The upstream repo shows a recent push on 2026-05-12, indicating ongoing activity, but the latest tagged update in the provided history is v2.2.0 (2024-11-18), so the published updates cadence looks slow rather than fast-moving.
- Update cadence (from evidence): Tag dates suggest a pattern of occasional updates (for example, v2.0.x in 2023, v2.1.x in 2023-2024, and v2.2.0 in late 2024), with no clearly documented tags after 2024-11 in the provided data.
AI summary generated
Recent updates
v2.2.0
v2.2.0 adds support for React 19 and fixes the `solid/arrow-left-circle` icon by removing an unnecessary clipping path. The only code-level behavior change visible in the diff is the SVG cleanup, and the only package-level change is updating React peer dependency compatibility metadata.
Featuresv2.1.5
Release v2.1.5 primarily adds a set of new SVG icon assets. The only documented change in the release notes is the addition of specific icon names (arrows, text style icons, document/currency icons, etc.).
Featuresv2.1.4
v2.1.4 is a small maintenance release that claims to improve tree-shakability of the React package. The diff also shows documentation example updates and build output annotation changes intended to help bundlers.
v2.1.3
Release v2.1.3 primarily updates documentation. The diff shows changes limited to README-related content, plus minor packaging metadata tweaks so the new framework-specific README files are included in the published npm packages.
v2.1.2
Release v2.1.2 primarily updates the published package contents to include a LICENSE file. The code diff also modifies the GitHub Actions publish workflow to add npm provenance attestation support when publishing to npm.
v2.1.1
Release v2.1.1 is presented as a small fix for chevrons. The diff shows SVG updates to multiple chevron icons (including size 20 solid variants) and a change in how the chevron strokes are rendered and colored.
v2.1.0
Heroicons v2.1.0 introduces a new micro icon style, adding a large set of 16x16 icons intended for higher density UI layouts. The release notes also document icon naming changes, specifically related to `*-on-rectangle` variants, and guidance to prefer mini or micro sets over `*-small` variants.
BreakingFeaturesv2.0.18
Release v2.0.18 is labeled as a fix for incorrect ESM paths in the published package exports for both @heroicons/react and @heroicons/vue. The diff shows the ESM export targets were updated to point at the correct esm entry files.
v2.0.17
v2.0.17 primarily updates the generated React icon TypeScript types. Release notes document a single fix, React icon types, and the code diff shows an adjustment to the type template used when building React components.
v2.0.16
v2.0.16 updates the @heroicons/react and @heroicons/vue packages to add a root-level entrypoint (package export) intended to satisfy Vite optimizeDeps. The implementation is a stub/proxy module that does not provide actual icon exports and instead directs consumers to import from the versioned subpaths (20/24, solid/outline).