Releases

Changelogs for each Base UI release.

May 19, 2026
v1.5.0Latest
- Improve closed popup mount performance by up to 50% and unmounting performance by up to 85%.
- Allow Persian digits in NumberField.
- Support Ctrl and Cmd shortcuts in OTPField.
- Rename sanitizeValue to normalizeValue and allow composing with validation in <OTPField.Root>.
- Add data-popup-side to <Select.Trigger>.
- Submit the associated form when pressing Enter on Checkbox.
- Integrate inline positioning in PreviewCard.
- Many accessibility, performance, and bug fixes.
Apr 20, 2026
v1.4.1
- Fix package installation errors and regressions.
Apr 13, 2026
v1.4.0
- New OTPField component (preview).
- Toasts can now update an existing notification by ID.
- Many accessibility, form, focus, and rendering bug fixes.
Mar 12, 2026
v1.3.0
- Drawer is now stable.
- Menu now supports content transitions with Viewport.
- New Label parts for Select, Combobox, and Slider.
- New SwipeArea part for Drawer.
- New InputGroup parts for Combobox and Autocomplete.
- New closeOnClick prop for Tooltip.
- Many accessibility, performance, and bug fixes.
Feb 12, 2026
v1.2.0
- New Drawer component (preview).
- New useFilteredItems hook for Autocomplete and Combobox.
- Support lazy element in render.
- Tons of Combobox and Autocomplete improvements.
- Support keepMounted on NavigationMenu.
- Support finalFocus on Select.
Jan 15, 2026
v1.1.0
- loopFocus support for Autocomplete + Combobox.
- New state attributes for Autocomplete + Combobox.
- New placeholder prop for Combobox + Select.
- New CSPProvider for configuring CSP behaviour.
- Many a11y and bug fixes.
Dec 11, 2025
v1.0.0
- Stable 🎉
- 35 unstyled UI components.
- New @base-ui/react npm package.
- New website.
- Fixed focus and transition issues across multiple components.
- Improved accessibility and form submission handling.
Dec 11, 2025
v1.0.0-rc.2
- Same code as v1.0.0.
Dec 11, 2025
v1.0.0-rc.1
- Same code as v1.0.0.
Dec 4, 2025
v1.0.0-rc.0
- Fixed missing 'use client' directives.
- Breaking change: Match native unchecked state in Checkbox and Switch.
- Breaking change: Fixed Panel keepMounted behavior in Tabs.
- Breaking change: Removed the keepHighlight prop from Combobox.
- New highlightItemOnHover prop for Menu and Select.
- Improved NumberField parsing and validation.
- Fixed Dialog and Popover closing behavior.
Nov 27, 2025
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.
Nov 17, 2025
v1.0.0-beta.6
- Hotfix for AlertDialog, Dialog, Menu, Popover, and Tooltip in React Server Components.
- Fixed refs types in Checkbox, Switch and Radio components.
Nov 17, 2025
v1.0.0-beta.5
- New Button component.
- Detachable triggers for popup components.
- Improved scrollbar support for popups.
- Huge Autocomplete + Combobox improvements.
- Many a11y and bug fixes.
Oct 1, 2025
v1.0.0-beta.4
- New autoHighlight prop on Combobox.
- openMultiple + toggleMultiple renamed to multiple.
- New Select.List component.
- New thumbAlignment prop on Slider.
- Support for variable height Toast.
- Many a11y and bug fixes.
Sep 3, 2025
v1.0.0-beta.3
- New Combobox + Autocomplete components.
- initialFocus + finalFocus now accept functions.
- useRender hook enhancements.
- Improved SSR support.
- Many a11y and bug fixes.
Jul 30, 2025
v1.0.0-beta.2
- New multiple prop on Select to create a multi-select.
- New llms.txt and markdown links for AI.
Jul 1, 2025
v1.0.0-beta.1
- New SubmenuRoot part for menus.
- Fixes for Accordion + Collapsible resizing.
- Perf enhancements for Select.
- Many small fixes for menus.
- useRender now RSC compatible.
- Many a11y and bug fixes.
May 29, 2025
v1.0.0-beta.0
- New Menubar component.
- New NavigationMenu component.
- New ContextMenu component.
- Improved performance.
- Many a11y and bug fixes.
Apr 17, 2025
v1.0.0-alpha.8
- New Toast component.
- New Meter component.
- Composable popup modality.
- Configurable NumberField snapping.
- New Content part for ScrollArea.
- New Label part for Progress.
- Many a11y and bug fixes.
Mar 20, 2025
v1.0.0-alpha.7
- New Toolbar component.
- New useRender hook.
- New modal prop on Popover.
- New actionsRef prop on popups.
- New locale prop on NumberField.
Feb 6, 2025
v1.0.0-alpha.6
- New Avatar component.
- New filled and focused style hooks for Field.
- New Value part for Progress.
- Support submenus when openOnHover is present.
- Many a11y and bug fixes.
Jan 10, 2025
v1.0.0-alpha.5
- New Portal part for popup components.
- Improved modality of popup components.
- Fixed openOnHover issues for popup components.
- Fixed Enter key bug when rendering menuitem as <a>.
- Many a11y and bug fixes.
Dec 17, 2024
v1.0.0-alpha.4
- 25 accessible UI components.
- Unstyled. Compatible with any styling engine.
- Fully composable with an open API.

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

# Install by master commit hash
npm i https://pkg.pr.new/@base-ui/react@ad745f1

# Install by PR number
npm i https://pkg.pr.new/@base-ui/react@3713

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

package.json

{
  "dependencies": {
    "@base-ui/react": "https://pkg.pr.new/@base-ui/react@..."
  }
}

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.

Releases

v1.5.0Latest