v3.2.5 v3.2.6

medium risk

heroui-inc/herouiSep 10, 2026 → Sep 17, 20267 days between releases

What's New

Adds AvatarGroup layouts and performance optimizations, but requires peer dependency updates.

Breaking Changes

  • @internationalized/date@^3.12.4 is now a peer dependency.
  • React Aria requirements have changed.

New Features

  • AvatarGroup now supports stacked, grid layouts, overflow counts, and shared styling.

Improvements

  • Reduced unnecessary re-renders across 43 components for better performance.
  • React Aria upgraded to version 1.21.1.
  • Calendar year picker labels now stay in sync with locale and time zone.
  • Focus rings restored to keyboard-only behavior for interactive elements.

Bug Fixes

  • Fixed spacing issues in Tag and Breadcrumb components.
  • Fixed ColorSlider validation warnings in production.

Upgrade Notes

Ensure `@internationalized/date@^3.12.4` is installed as a peer dependency. Review React Aria requirements as they have changed.

The Two Releases

v3.2.5

v3.2.5

Sep 10, 2026· 1 month ago

This release addresses a security vulnerability in the Parcel dependency, improves documentation accessibility and SEO, and fixes bugs in the autocomplete and number-field components.

Full release notes
v3.2.6

v3.2.6

Sep 17, 2026· 1 month ago

This release focuses on performance optimization with reduced unnecessary re-renders across 43 components, introduces new grid and stacked layouts for the AvatarGroup component, and restores keyboard-only focus rings for interactive elements. It also includes updates to React Aria and fixes for spacing issues in Tag and Breadcrumb components. Note that peer dependency requirements have been updated.

Full release notes