Releases

• Apr 13, 2026

  v1.4.0Latest

  • 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:

# 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:

{
  "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.