base-ui README

The project's README from github.com/mui/base-ui. As one markdown file: README.md.

Base UI

From the creators of Radix, Floating UI, and Material UI, Base UI is an unstyled UI component library for building accessible user interfaces.


Documentation

To get started, check out the Base UI documentation.

Contributing

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

Releases

To see the latest updates, check out the releases.

Community

Team

License

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

base-ui (mui/base-ui)

a11y
Searching Database…

11.2K ·GitHub
What is this?Base UI is an open-source, unstyled React component library for building accessible user interfaces and design systems, created by the team behind Radix, Floating UI, and Material UI.
Is this a styled component kit or something I style myself?It is unstyled by design: Base UI ships the component logic and accessible behavior only, and you add your own CSS, CSS-in-JS, or design tokens on top.
How do I add it to a React project?You install the package with your package manager and import the components you need, following the setup walkthrough in the official Base UI documentation.
Do I need React to use this?Yes, Base UI is a React component library so your app needs React; the repo itself is developed as a pnpm/Lerna monorepo (pnpm 12.4.1, Node >=22.23.2).
Does it include any default visual styling?No, since the components are intentionally unstyled you have to write your own styles or wire up a design system yourself — there is no built-in theme or CSS.
Who is this for — app developers or design-system authors?Both: app developers can use the accessible primitives directly, while teams building their own component library or design system can use Base UI as the unstyled, accessible foundation.
Why did the Material UI team build another unstyled component library?To give developers fully unstyled, WAI-ARIA-compliant primitives for complete design freedom, taking the Radix-style headless approach and combining it with the team's years of experience shipping Material UI.
How does Base UI relate to Radix and Floating UI?It's built by the same core creators, merging Radix's unstyled-primitive philosophy with Floating UI's positioning engine under one unified React library.
Is Base UI actively maintained?Yes, the repo runs CI (lint, CodeQL, release automation), ships regular releases, and has over 11k GitHub stars, indicating active development.
What accessibility standard do the components target?The components are built around WAI-ARIA authoring practices, as reflected in the project's listed topics, aiming for accessible behavior out of the box.
Creator
mui
Size
48.9 MB
Stars
11.2K
Age
2y
Commits · 90 Days