@base-ui-components/react
Advanced tools
Base UI is a library of headless ('unstyled') React components and low-level hooks. You gain complete control over your app's CSS and accessibility features.
Base UI is a library of unstyled React components. You gain complete control over your app's CSS and accessibility features.
Install the package in your project directory with:
npm install @base-ui-components/react
Visit base-ui.com to view the full documentation.
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.
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.
The changelog is regularly updated to reflect what's changed in each new release.
Future plans and high-priority features and enhancements can be found in the roadmap.
This project is licensed under the terms of the MIT license.
For details of supported versions and contact details for reporting security issues, please refer to the security policy.
v1.0.0-beta.1
Jul 1, 2025
undefined is passed explicitly (#2151) by @michaldudakaria-controls reference (#2170) by @atomiksField.Label.
If Field.Label encloses Switch/Checkbox/Radio, the htmlFor/id attributes are no longer explicitly set to associate them.
(#2036) by @mj12albertuseRenderElement (#2053) by @mj12albertid on the <input> element (#2115) by @mj12albertonCheckedChange not running when parent checkbox is present (#2155) by @mj12albertaria-controls reference (#2170) by @atomiksSubmenuRoot part.
Nested menus should be defined with Menu.SubmenuRoot instead of Menu.Root to to avoid ambiguity.
(#2042) by @atomiksField.Label.
If Field.Label encloses Switch/Checkbox/Radio, the htmlFor/id attributes are no longer explicitly set to associate them.
(#2036) by @mj12albertonValueChange value type (#2112) by @atomiksField.Label focusing trigger (#2118) by @atomiksuseRenderElement (#2053) by @mj12albertonValueChange value type (#2112) by @atomiksSubmenuRoot part.
Nested menus should be defined with Menu.SubmenuRoot instead of Menu.Root to to avoid ambiguity.
(#2042) by @atomiksrole from Trigger (#2047) by @atomiksclose event on cancel-open (#2067) by @atomikshighlighted to item State (#2079) by @atomikscloseOnClick: false not working in nested menus (#2094) by @michaldudakonValueChange is called with already-formatted parsed value (#1905) by @atomiksField.Label.
If Field.Label encloses Radio, the htmlFor/id attributes are no longer explicitly set to associate them.
(#2036) by @mj12albertuseRenderElement (#2053) by @mj12albertdata-scrolling during programmatic scroll (#1908) by @atomiksSelect.Value.
<Select.Value> now prints the raw value by default unless an items prop is specified on Select.Root.
See https://base-ui.com/react/components/select#formatting-the-value for more information.
(#2087) by @atomiksField.Label focusing trigger (#2118) by @atomikshighlighted to item State (#2079) by @atomiksvalue as state (#2153) by @atomiksFieldRoot.State type (#2192) by @atomiksField.Label.
If Field.Label encloses Switch, the htmlFor/id attributes are no longer explicitly set to associate them.
(#2036) by @mj12albertdisabled attr on toolbar button when focusableWhenDisabled={false} (#2176) by @mj12albertAll contributors of this release in alphabetical order: @aarongarciah, @atomiks, @bernardobelchior, @brijeshb42, @Janpot, @juliomerisio, @lesha1201, @michaldudak, @mj12albert, @oliviertassinari, @romgrk
FAQs
Base UI is a library of headless ('unstyled') React components and low-level hooks. You gain complete control over your app's CSS and accessibility features.
The npm package @base-ui-components/react receives a total of 58,388 weekly downloads. As such, @base-ui-components/react popularity was classified as popular.
We found that @base-ui-components/react demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 6 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Meet Socket at Black Hat & DEF CON 2025 for 1:1s, insider security talks at Allegiant Stadium, and a private dinner with top minds in software supply chain security.
Security News
CAI is a new open source AI framework that automates penetration testing tasks like scanning and exploitation up to 3,600× faster than humans.
Security News
Deno 2.4 brings back bundling, improves dependency updates and telemetry, and makes the runtime more practical for real-world JavaScript projects.