@base-ui-components/react

Base UI is a library of unstyled React components. You gain complete control over your app's CSS and accessibility features.

Installation

Install the package in your project directory with:

npm install @base-ui-components/react

Documentation

Visit base-ui.com to view the full documentation.

Questions

For how-to questions that don't involve making changes to the code base, please use Stack Overflow instead of GitHub issues. Use the "base-ui" tag on Stack Overflow to make it easier for the community to find your question.

Contributing

Read the contributing guide to learn about our development process, how to propose bug fixes and improvements, and how to build and test your changes.

Contributing to Base UI is about more than just issues and pull requests! There are many other ways to support Base UI beyond contributing to the code base.

Changelog

The changelog is regularly updated to reflect what's changed in each new release.

Roadmap

Future plans and high-priority features and enhancements can be found in the roadmap.

License

This project is licensed under the terms of the MIT license.

Security

For details of supported versions and contact details for reporting security issues, please refer to the security policy.

Changelog

v1.0.0-beta.2

Jul 30, 2025

General changes

• Fix navigator checks and ensure safe platform retrieval (#2273) by @mo36924
• Prevent Space key default on keydown (#2295) by @atomiks
• Check for performance existence on server (#2316) by @atomiks

Accordion

• Destructure render prop (#2280) by @atomiks
• Fix keyboard interactions with elements in the panel (#2321) by @mj12albert
• Fix open transitions in Safari/Firefox (#2327) by @atomiks

Alert Dialog

• Support ShadowRoot containers (#2236) by @atomiks
• Add forceRender prop to Backdrop part (#2037) by @atomiks
• Improve outside press behavior with touch input (#2334) by @atomiks

Checkbox

• Fix focusing form controls with inputRef (#2252) by @mj12albert

Collapsible

• Destructure render prop (#2323) by @atomiks
• Fix open transitions in Safari/Firefox (#2327) by @atomiks

Dialog

• Support ShadowRoot containers (#2236) by @atomiks
• Add forceRender prop to Backdrop part (#2037) by @atomiks
• Improve outside press behavior with touch input (#2334) by @atomiks
• Use click event for outside press dismissal (#2275) by @atomiks

Field

• Deregister fields from Form when unmounting (#2231) by @mj12albert

Form

• Deregister fields from Form when unmounting (#2231) by @mj12albert

Menu

• Support ShadowRoot containers (#2236) by @atomiks
• Avoid double useRenderElement passes (#2256) by @atomiks
• Improve outside press behavior with touch input (#2334) by @atomiks
• Close submenus when focus is lost by shift-tabbing (#2290) by @michaldudak

Menubar

• Fix triggers role (#2317) by @atomiks

Meter

• Fix ARIA attributes and update docs (#2267) by @mj12albert

Navigation Menu

• Breaking change: Support inlined nesting. Ensure the popup's width is set to var(--popup-width) unconditionally (without the media query) on the .Popup class. (#2269) by @atomiks
• Avoid double useRenderElement passes (#2256) by @atomiks
• Add useButton integration to Trigger (#2296) by @atomiks
• Fix popup size transitions on iOS (#2387) by @atomiks

Number Field

• Remove invalid prop (#2315) by @atomiks
• Fix button disabled state only including root disabled state (#2268) by @mj12albert

Popover

• Support ShadowRoot containers (#2236) by @atomiks
• Remove ancestor nodes from inside elements for outside press detection (#2339) by @atomiks
• Improve outside press behavior with touch input (#2334) by @atomiks
• Use click event for outside press dismissal (#2275) by @atomiks

Preview Card

• Support ShadowRoot containers (#2236) by @atomiks

Progress

• Fix ARIA attributes and update docs (#2267) by @mj12albert

Radio Group

• Add aria-required attribute (#2227) by @cgatian
• Extend state with FieldRoot.State (#2251) by @mj12albert
• Fix focusing form controls with inputRef (#2252) by @mj12albert
• Avoid double useRenderElement passes (#2256) by @atomiks

Scroll Area

• Disable user-select on scrollbar and non-main button interactions (#2338) by @atomiks

Select

• Support ShadowRoot containers (#2236) by @atomiks
• Add value and readOnly to Select.Trigger state (#2237) by @atomiks
• Add multiple prop (#2173) by @atomiks
• Allow typeahead while open for multiple mode (#2274) by @atomiks
• Ensure positionerElement is available in document mouseup (#2276) by @atomiks
• Fix alignItemWithTrigger fallback scroll jump (#2241) by @atomiks
• Support conditional multiple prop in types (#2369) by @atomiks
• Fix multiple ARIA behavior on touch (#2333) by @atomiks
• Improve outside press behavior with touch input (#2334) by @atomiks

Slider

• Fix focusing form controls with inputRef (#2252) by @mj12albert

Toast

• Fix promise method timeout option handling (#2294) by @atomiks
• Make Toast.Viewport an announce container (#2246) by @atomiks

Toggle

• Avoid double useRenderElement passes (#2256) by @atomiks

Toggle Group

• Avoid double useRenderElement passes (#2256) by @atomiks

Toolbar

• Avoid double useRenderElement passes (#2256) by @atomiks

Tooltip

• Support ShadowRoot containers (#2236) by @atomiks
• Memoize leftover object in tooltip (#2250) by @sai6855
• Fix error when combining defaultOpen and disabled (#2374) by @atomiks

All contributors of this release in alphabetical order: @aelfannir, @atomiks, @brijeshb42, @cgatian, @Janpot, @michaldudak, @mj12albert, @mo36924, @romgrk, @sai6855