Skip to content

[docs] Migrate @mui/base to Base UI#48169

Open
Ayusht323 wants to merge 2 commits intomui:masterfrom
Ayusht323:docs-migrate-base-ui
Open

[docs] Migrate @mui/base to Base UI#48169
Ayusht323 wants to merge 2 commits intomui:masterfrom
Ayusht323:docs-migrate-base-ui

Conversation

@Ayusht323
Copy link
Copy Markdown

Summary
This PR fully migrates the @mui/base dependency to @base-ui-components/react within the documentation and internal docs packages, resolving issue #48158.

Key Changes:

Updated docs/package.json to use @base-ui-components/react@1.0.0-rc.0.

Replaced all core @mui/base component imports across the docs/src and packages/mui-docs directories.

Updated component APIs where necessary to align with Base UI's new compound component architecture.

Important Note: Base UI 1.0.0-rc.0 removed standalone exports for NoSsr, Portal, FocusTrap, and ClickAwayListener. I have migrated these specific utility imports to fallback on @mui/material to prevent runtime crashes.

Quality Checks:

Local docs build succeeds.

Passed all local TS, Prettier, and ESLint checks.

Closes #48158

@mui-bot
Copy link
Copy Markdown

mui-bot commented Apr 1, 2026

Netlify deploy preview

Bundle size report

Bundle Parsed size Gzip size
@mui/material 0B(0.00%) 0B(0.00%)
@mui/lab 0B(0.00%) 0B(0.00%)
@mui/system 0B(0.00%) 0B(0.00%)
@mui/utils 0B(0.00%) 0B(0.00%)

Details of bundle changes

Generated by 🚫 dangerJS against a3471d3

@zannager zannager added the docs Improvements or additions to the documentation. label Apr 1, 2026
@zannager zannager requested a review from siriwatknp April 1, 2026 15:55
@Ayusht323 Ayusht323 force-pushed the docs-migrate-base-ui branch 4 times, most recently from 0f13166 to ec7c440 Compare April 2, 2026 03:33
@github-actions github-actions bot added the PR: out-of-date The pull request has merge conflicts and can't be merged. label Apr 2, 2026
@Ayusht323 Ayusht323 force-pushed the docs-migrate-base-ui branch from ec7c440 to a3471d3 Compare April 4, 2026 07:52
@github-actions github-actions bot removed the PR: out-of-date The pull request has merge conflicts and can't be merged. label Apr 4, 2026
@zannager zannager added the scope: all components Widespread work has an impact on almost all components. label Apr 6, 2026
@github-actions github-actions bot added the PR: out-of-date The pull request has merge conflicts and can't be merged. label Apr 7, 2026
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. PR: out-of-date The pull request has merge conflicts and can't be merged. scope: all components Widespread work has an impact on almost all components.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[docs] Migrate @mui/base to Base UI

3 participants