Skip to content

Conversation

oliviertassinari
Copy link
Member

@oliviertassinari oliviertassinari commented Sep 25, 2025

In https://www.reddit.com/r/reactjs/comments/1k1gerj/in_2025_whats_the_goto_reactjs_ui_library/, you can find levels of confusion:

SCR-20250926-cbfh

Now, when I see: https://www.npmjs.com/package/@mui/base

SCR-20250926-ccls

or https://mui.com/blog/base-ui-2024-plans/. It feels like we add confusion, we dont have a clear separation between the two; Hence this PR and #46979.

We started the work, e.g. #45060, but it doesn't feel like we ever finished it. I don't know if this PR is enough to call it done, but this feels like we're getting closer.

@oliviertassinari oliviertassinari added docs Improvements or additions to the documentation. package: @mui/base Specific to @mui/base (legacy). labels Sep 25, 2025
@oliviertassinari oliviertassinari changed the title [docs] Clearify mui base [docs] Clearify MUI Base -> Base UI Sep 25, 2025
@mui-bot
Copy link

mui-bot commented Sep 25, 2025

@oliviertassinari oliviertassinari force-pushed the clearify-mui-base branch 4 times, most recently from bcf5074 to 26c0b30 Compare September 25, 2025 23:39
@oliviertassinari oliviertassinari changed the title [docs] Clearify MUI Base -> Base UI [docs] Clearify MUI Base != Base UI Sep 25, 2025
@oliviertassinari oliviertassinari added the type: bug It doesn't behave as expected. label Sep 25, 2025
@oliviertassinari oliviertassinari changed the title [docs] Clearify MUI Base != Base UI [docs] Clearify MUI Base != Base UI (1/2) Sep 25, 2025
@mapache-salvaje mapache-salvaje changed the title [docs] Clearify MUI Base != Base UI (1/2) [docs] Clarify MUI Base != Base UI (1/2) Sep 26, 2025
# MUI Base - Create React App example in TypeScript

[MUI Base](https://mui.com/base-ui/) is a library of unstyled React UI components and hooks.
[MUI Base](https://v6.mui.com/base-ui/getting-started/) is a library of unstyled React UI components and hooks.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Might be helpful to add (legacy) to these examples for extra clarity? I don't have a strong opinion so feel free to use or discard.

Suggested change
[MUI Base](https://v6.mui.com/base-ui/getting-started/) is a library of unstyled React UI components and hooks.
[MUI Base](https://v6.mui.com/base-ui/getting-started/) (legacy) is a library of unstyled React UI components and hooks.

export default function App() {
return (
<div className="box">
<h1>Base UI + Create React App scaffold (TypeScript)</h1>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks like some of the titles (and directories) still say "Base UI." Honestly I think we should just remove these examples entirely. We don't want people to use MUI Base so we shouldn't give them boilerplates to start with. As long as MUI Base exists it will continue to confuse some people looking for Base UI.

Copy link
Member Author

@oliviertassinari oliviertassinari Sep 29, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ah yes, let's fix this.

As for use case of those examples, I only see making it easier to report regressions for people migrating from MUI Base to Base UI. It's in the v6.x branch, so it's mostly hidden.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
docs Improvements or additions to the documentation. package: @mui/base Specific to @mui/base (legacy). type: bug It doesn't behave as expected. v6.x
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants