stack.pulse
#stacks/base-ui/ui

Base UI release notes, breaking changes, and upgrade notes.

Unstyled UI components for building accessible interfaces StackPulse turns upstream changelogs into scannable summaries with risky changes, deprecations, migration notes, and source links.

releases
6
breaking
3
security
0
deprecated
0
migrations
3

Get source-linked upgrade notes and occasional sponsor recommendations. No GitHub login required.

what stackpulse tracks

Base UI releases from GitHub

StackPulse watches Base UI release notes and keeps the original source link close to every summary.

upgrade risk

Breaking changes and deprecations

Risky changes are separated from normal feature notes so you can scan upgrade impact before changing production dependencies.

migration notes

Source-backed next steps

Migration steps and recommended actions are only shown when the upstream release notes support them.

# latest_releases

source-backed
v1.6.0mediumbreakingmigrationfeatureJun 18, 2026

v1.6.0

This release focuses on bug fixes and improvements across various components, including Accordion, Autocomplete, Checkbox, Combobox, and more. Notable changes include enhanced keyboard navigation, focus management, and edge case handling.

affected

Developers using the OTP Field component will need to update their imports due to the breaking change.

action

Update imports for OTP Field from `OTPFieldPreview` to `OTPField`.

release_signals
-๐Ÿšจ **Breaking change:** Unmark preview for OTP Field. The namespace export is renamed `OTPFieldPreview` โ†’ `OTPField` and should be imported as: `{ OTPField } from '@base-ui/react/otp-field'` (#5029)
+- Add virtual keyboard provider for Drawer (#4353)
+- Document `open` requirement for the `inline` prop in Autocomplete and Combobox (#5069)
+- Sync value text with indicator in Meter (#4904)
+- Add scrolling state to Thumb in Scroll Area (#4982)
+- Commit swipe on primary-button release in Drawer (#5057)
migration_steps1 steps
  1. 01For OTP Field, update imports from `OTPFieldPreview` to `OTPField` (#5029)
view source on github->
v1.5.0mediumbreakingmigrationfeatureMay 19, 2026

v1.5.0

This release focuses on performance improvements, bug fixes, and enhancements across various components, including significant mount/unmount performance gains and better handling of popups and focus management.

affected

Developers using OTP Field need to update their code due to the breaking change in method naming.

action

Update OTP Field implementations to use `normalizeValue()` instead of `sanitizeValue()`.

release_signals
-Rename `sanitizeValue()` to `normalizeValue()` in OTP Field
+Improve mount performance with interaction splitting
+Expose clear visibility state in Combobox
+Support Persian digits in Number Field keyboard input
+Support <kbd>Ctrl</kbd> and <kbd>Cmd</kbd> shortcuts in OTP Field
+Add `data-popup-side` to Select trigger
migration_steps1 steps
  1. 01Update OTP Field code to use `normalizeValue()` instead of `sanitizeValue()`
view source on github->
v1.4.1lowfeatureApr 20, 2026

v1.4.1

This release focuses on bug fixes and improvements, particularly around event handling, tabbability, and navigation menu behavior.

affected

Users experiencing issues with event handling, tabbability, or navigation menu behavior may benefit from this release.

action

Update to v1.4.1 to benefit from bug fixes and improvements.

view source on github->
v1.4.0mediumfeatureApr 13, 2026

v1.4.0

This release focuses on bug fixes and improvements across various components, including enhancements to form handling, accessibility, and touch interactions.

affected

Developers using Base UI components, particularly those dealing with forms, accessibility, and touch interactions, will benefit from these fixes and improvements.

action

Update to v1.4.0 to take advantage of the latest bug fixes and improvements.

release_signals
+Add `suppressHydrationWarning` to hidden inputs
+Add preview `OTPField` component for one-time password and verification code entry
+Add upsert support to `add` method in Toast component
view source on github->
v1.3.0highbreakingmigrationfeatureMar 12, 2026

v1.3.0

This release introduces several optimizations, bug fixes, and new features across various components, including improvements to keyboard navigation, hover interactions, and accessibility. The `Drawer` component is now stable, marking a breaking change for users.

affected

Users of the `Drawer` component are affected by the breaking change, requiring updates to import statements.

action

Update `Drawer` import statements to use the stable version.

release_signals
-`Drawer` is no longer marked as preview and should be imported as `{ Drawer } from '@base-ui/react/drawer'`
+Add generic `Value` typing for Accordion
+Add `InputGroup` part to Autocomplete and Combobox
+Add automatic `aria-labelledby` support for Checkbox, Radio Group, and Switch
+Add `Label` part to Combobox, Select, and Slider
+Add `closeOnClick` prop to Tooltip
migration_steps1 steps
  1. 01Update `Drawer` imports from `{ Drawer } from '@base-ui/react/drawer'`
view source on github->
v1.2.0mediumfeatureFeb 12, 2026

v1.2.0

This release introduces several bug fixes and improvements across various components, including Autocomplete, Combobox, and Checkbox. Notable changes include enhanced event handling, better accessibility support, and performance optimizations.

affected

Developers using components like Autocomplete, Combobox, and Checkbox may need to update their implementations to take advantage of new features and fixes.

action

Review the release notes and update your codebase to incorporate new features and fixes where applicable.

release_signals
+Add `useFilteredItems` hook for Autocomplete
+Add transition attributes to Avatar
+Add `autoComplete` prop for explicit browser autofill support in Combobox
+Add `keepMounted` prop to Navigation Menu Content
+Add `allowOutOfRange` prop to Number Field
view source on github->
Base UI release notes, breaking changes, and upgrade notes ยท StackPulse