Back to Explore

tailwindlabs/heroicons

GitHub
1 watchersOpen source

Last release: 11/18/2024

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

  • Heroicons is actively maintained, with an upstream GitHub push as of 2026-05-12, and tagged updates continuing in 2024 (latest noted update: v2.2.0 on 2024-11-18).
  • The apparent update cadence (based on the provided tag history) is roughly every few months in 2024, including minor maintenance (v2.1.4) and a larger metadata or compatibility update (v2.2.0) plus asset additions (v2.1.5).

AI summary generated Today

AI-generated from public sources. May be inaccurate. Report

Recent updates

  • v2.2.0

    11/18/2024

    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.

    Features

  • v2.1.5

    7/10/2024

    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.).

    Features

  • v2.1.4

    6/17/2024

    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

    3/22/2024

    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

    3/22/2024

    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

    12/18/2023

    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

    12/18/2023

    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.

    BreakingFeatures

  • v2.0.18

    5/9/2023

    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

    3/30/2023

    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

    2/17/2023

    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).