Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions docs/data/base/components/autocomplete/autocomplete.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,8 @@ title: React Autocomplete hook
hooks: useAutocomplete
githubLabel: 'component: autocomplete'
waiAria: https://www.w3.org/WAI/ARIA/apg/patterns/combobox/
newName: Combobox
newUrl: https://base-ui.com/react/components/autocomplete
---

# Autocomplete
Expand Down
2 changes: 2 additions & 0 deletions docs/data/base/components/snackbar/snackbar.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,8 @@ title: React Snackbar component and hook
components: Snackbar
hooks: useSnackbar
githubLabel: 'component: snackbar'
newName: Toast
newUrl: https://base-ui.com/react/components/toast
---

# Snackbar
Expand Down
16 changes: 6 additions & 10 deletions docs/src/components/productBaseUI/MuiBaseDeprecation.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -2,18 +2,15 @@ import * as React from 'react';
import Box from '@mui/material/Box';
import { MarkdownElement } from '@mui/docs/MarkdownElement';

export default function MuiBaseDeprecation(props: {
newComponentName?: string;
newComponentUrl?: string;
}) {
if (props.newComponentUrl && props.newComponentName) {
export default function MuiBaseDeprecation(props: { newName?: string; newUrl?: string }) {
if (props.newUrl && props.newName) {
return (
<MarkdownElement>
<Box component="aside" className="MuiCallout-root MuiCallout-error">
<Icon />
<Box className="MuiCallout-content">
@mui/base has been deprecated and has been replaced by Base UI. We strongly recommend
using the Base UI <a href={props.newComponentUrl}>{props.newComponentName} component</a>{' '}
MUI Base (@mui/base) has been deprecated. Base UI is its successor. We strongly
recommend using the new <a href={props.newUrl}>Base UI {props.newName} component</a>{' '}
instead.
</Box>
</Box>
Expand All @@ -25,9 +22,8 @@ export default function MuiBaseDeprecation(props: {
<Box component="aside" className="MuiCallout-root MuiCallout-error">
<Icon />
<Box className="MuiCallout-content">
@mui/base has been deprecated and has been replaced by{' '}
<a href="https://base-ui.com">Base UI</a>. We strongly recommend using the new package
instead.
MUI Base (@mui/base) has been deprecated. <a href="https://base-ui.com">Base UI</a> is its
successor. We strongly recommend using the new package instead.
</Box>
</Box>
</MarkdownElement>
Expand Down
4 changes: 2 additions & 2 deletions docs/src/modules/components/MarkdownDocs.js
Original file line number Diff line number Diff line change
Expand Up @@ -78,8 +78,8 @@ export default function MarkdownDocs(props) {
{isJoy && <JoyModeObserver mode={theme.palette.mode} />}
{isBase && (
<MuiBaseDeprecation
newComponentUrl={localizedDoc.headers.newUrl}
newComponentName={localizedDoc.headers.newName}
newUrl={localizedDoc.headers.newUrl}
newName={localizedDoc.headers.newName}
/>
)}
{localizedDoc.rendered.map((renderedMarkdownOrDemo, index) => (
Expand Down
4 changes: 2 additions & 2 deletions docs/src/modules/components/MarkdownDocsV2.js
Original file line number Diff line number Diff line change
Expand Up @@ -276,8 +276,8 @@ export default function MarkdownDocsV2(props) {
{isJoy && <JoyModeObserver mode={theme.palette.mode} />}
{isBase && (
<MuiBaseDeprecation
newComponentUrl={localizedDoc.headers.newUrl}
newComponentName={localizedDoc.headers.newName}
newUrl={localizedDoc.headers.newUrl}
newName={localizedDoc.headers.newName}
/>
)}
{commonElements}
Expand Down
2 changes: 1 addition & 1 deletion examples/base-ui-cra-ts/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# 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.


[Create React App](https://create-react-app.dev/) is a framework for quickly creating a new React project without the need to configure complex build tools or development environments.

Expand Down
2 changes: 1 addition & 1 deletion examples/base-ui-cra-ts/src/App.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ export default function App() {
<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.

<div className="item">
<a href="https://mui.com/base-ui/">Base UI</a> is a library of unstyled React UI components
<a href="https://v6.mui.com/base-ui/getting-started/">MUI Base</a> is a library of unstyled React UI components
which includes prebuilt components with production-ready functionality, along with low-level
hooks for transferring that functionality to other components.
</div>
Expand Down
2 changes: 1 addition & 1 deletion examples/base-ui-cra/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# MUI Base - Create React App example in JavaScript

[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.

[Create React App](https://create-react-app.dev/) is a framework for quickly creating a new React project without the need to configure complex build tools or development environments.

Expand Down
2 changes: 1 addition & 1 deletion examples/base-ui-cra/src/App.js
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ export default function App() {
<div className="box">
<h1>Base UI + Create React App scaffold (JavaScript)</h1>
<div className="item">
<a href="https://mui.com/base-ui/">Base UI</a> is a library of unstyled React UI components
<a href="https://v6.mui.com/base-ui/getting-started/">MUI Base</a> is a library of unstyled React UI components
and hooks.
</div>
<div className="item">
Expand Down
2 changes: 1 addition & 1 deletion examples/base-ui-vite-tailwind-ts/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# MUI Base - Vite.js example with Tailwind CSS 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.

[Vite](https://vite.dev/) is a build tool that aims to provide a faster and leaner development experience for modern web projects, consisting of a dev server and a build command

Expand Down
2 changes: 1 addition & 1 deletion examples/base-ui-vite-tailwind/README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# MUI Base - Vite.js example with Tailwind CSS

[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.

[Vite](https://vite.dev/) is a build tool that aims to provide a faster and leaner development experience for modern web projects, consisting of a dev server and a build command

Expand Down
4 changes: 2 additions & 2 deletions examples/base-ui-vite-tailwind/src/App.jsx
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ export default function App() {
<h1 className="text-3xl font-semibold mb-4">MUI Base + Vite.js + Tailwind CSS</h1>
<ul>
<li className="card">
<a href="https://mui.com/base-ui/" className="link">
Base UI
<a href="https://v6.mui.com/base-ui/getting-started/" className="link">
MUI Base
</a>{' '}
is a library of unstyled React UI components and hooks.
</li>
Expand Down
10 changes: 5 additions & 5 deletions packages/mui-base/README.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
<!-- markdownlint-disable-next-line -->
<p align="center">
<a href="https://mui.com/base-ui/" rel="noopener" target="_blank"><img width="150" height="133" src="https://mui.com/static/logo.svg" alt="Base UI logo"></a>
<a href="https://v6.mui.com/base-ui/getting-started/" rel="noopener" target="_blank"><img width="150" height="133" src="https://mui.com/static/logo.svg" alt="MUI Base logo"></a>
</p>

<h1 align="center">Base UI</h1>
<h1 align="center">MUI Base</h1>

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.
MUI Base is a library of headless ("unstyled") React components and low-level hooks. You gain complete control over your app's CSS and accessibility features.

## Installation

Expand All @@ -19,7 +19,7 @@ npm install @mui/base

<!-- #host-reference -->

Visit [https://v6.mui.com/base-ui/](https://v6.mui.com/base-ui/) to view the full documentation.
Visit [https://v6.mui.com/base-ui/getting-started/](https://v6.mui.com/base-ui/getting-started/) to view the full documentation.

## Questions

Expand All @@ -28,7 +28,7 @@ Use the "base-ui" tag on Stack Overflow to make it easier for the community to

## Examples

Our documentation features [a collection of example projects using Base UI](https://github.com/mui/material-ui/tree/master/examples).
Our documentation features [a collection of example projects using MUI Base](https://github.com/mui/material-ui/tree/master/examples).

## Contributing

Expand Down
2 changes: 1 addition & 1 deletion packages/mui-base/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@
"bugs": {
"url": "https://github.com/mui/material-ui/issues"
},
"homepage": "https://mui.com/base-ui/",
"homepage": "https://v6.mui.com/base-ui/getting-started/",
"funding": {
"type": "opencollective",
"url": "https://opencollective.com/mui-org"
Expand Down
Loading