Skip to contents

Releases

Changelogs for each Base UI release.

View as Markdown
  • v1.2.0Latest

    • New Drawer component.
    • Added Menu.LinkItem for semantic navigation links.
    • New useFilteredItems hook for custom filtering in Autocomplete and Combobox.
    • Improved type safety and inference for Toggle and ToggleGroup.
    • Enhanced NumberField with allowOutOfRange prop.
  • v1.1.0

    • New CSP Provider component for Content Security Policy support.
    • Added loopFocus prop to Autocomplete and Combobox.
    • Fixed multiple accessibility and form integration issues.
    • Improved popup state attributes and detached trigger handling.
  • v1.0.0

    • Renamed packages to use the @base-ui org.
    • Fixed focus and transition issues across multiple components.
    • Improved accessibility and form submission handling.
  • v1.0.0-rc.0

    • Fixed missing "use client" directives.
    • Breaking change: Match native unchecked state in Checkbox and Switch form submission.
    • Breaking change: Fixed Panel keepMounted behavior in Tabs.
    • Improved Number Field parsing and validation.
  • v1.0.0-beta.7

    • Fixed error about props.ref access in React <=18.
    • Improved performance when detached triggers are used.
    • Fixed iOS VoiceOver voice control accessibility.
    • Improved popups anchoring and auto-focus behavior.
  • v1.0.0-beta.6

    • Hotfix for Alert Dialog, Dialog, Menu, Popover, and Tooltip in React Server Components.
    • Fixed refs types in Checkbox, Switch and Radio components.
  • v1.0.0-beta.5

    • Breaking change: Replaced trackAnchor with disableAnchorTracking.
    • Breaking change: Renamed loop to loopFocus.
    • New Button component.
    • Support for detached triggers in multiple components.
    • Improved form handling and validation.
  • v1.0.0-beta.4

    • Breaking change: Generic event details API.
    • Improved Combobox with support for object values.
    • Enhanced Select with item anchoring improvements.
    • Better Toast stacking with variable height support.
  • v1.0.0-beta.3

    • Breaking change: Base UI event details standardization.
    • New Autocomplete component.
    • New Combobox component.
    • Support for initialFocus and finalFocus functions.
  • v1.0.0-beta.2

    • Breaking change: Navigation Menu semantic element structure.
    • Added multiple prop to Select.
    • Improved outside press behavior with touch input.
    • Better ShadowRoot container support.
  • v1.0.0-beta.1

    • Breaking change: Support implicit Field.Label.
    • Context Menu SubmenuRoot part added.
    • Enable custom validation based on other form values.
    • Improved Accordion and Collapsible content resizing.
  • v1.0.0-beta.0

    • New Context Menu component.
    • New Menubar component.
    • New Navigation Menu component.
    • Checkbox Group value submission improvements.
    • Major refinements to OpenChangeReason.
  • v1.0.0-alpha.8

    • New Meter component.
    • New Toast component.
    • Reworked animations and transitions for Accordion and Collapsible.
    • Improved NumberField with snapOnStep prop.
  • v1.0.0-alpha.7

    • New Toolbar component.
    • Avatar component support.
    • NumberField locale support and parsing improvements.
    • Better focus restoration and modal handling.
  • v1.0.0-alpha.6

    • Added onOpenChangeComplete prop to multiple components.
    • Progress component Value part and format prop.
    • Field filled and focused style hooks.
    • Support for submenus with openOnHover prop.
  • v1.0.0-alpha.5

    • Breaking change: Portal part required for dialogs and popups.
    • Improved nested dialog handling.
    • ScrollArea RTL support and orientation improvements.
    • Slider thumb positioning improvements.

Canary Releases

A canary release is published for every master commit and pull request. Install one by using the corresponding pkg.pr.new URL:

Terminal

Your package.json will then reference the pkg.pr.new URL:

package.json

Canary releases may contain breaking changes. Check the associated pull requests on GitHub for details.

Full Release Notes

You can see the full changelog on GitHub.