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
- Actively maintained (with a caveat): The repository shows an upstream push on 2026-05-12, which indicates ongoing maintenance, though the specific published updates shown in the provided list are mostly from 2024 and earlier.
- Update cadence: Visible published updates are irregular, with several changes clustered in mid to late 2024 (v2.2.0 on 2024-11-18, then earlier 2024 entries), and no newer version details shown after that, despite the 2026 upstream activity.
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).