Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[material-next] Drop the @mui/material-next package #41544

Merged
merged 6 commits into from
Mar 18, 2024

Conversation

mnajdova
Copy link
Member

@mnajdova mnajdova commented Mar 18, 2024

We are dropping the @mui/material-next package.

Here is why. We have multiple ways to work on the next major version:

  • Two codebases, one active version focus:
    • Focus on the next branch, go under heavy breaking changes there, and have a master branch where we backport fixes, sometimes.
    • Focus on the master branch, where we focus on the next major, no major changes, and have a vX branch for the older version where we backport fixes, sometimes.
  • One codebase, two active versions:
    • Achieve this with two npm packages, @mui/material and @mui/material-next.

We are already working on the next Material UI version. We don't have the bandwidth to focus on both versions at the same time, and it is a maintenance burden to keep the package alive.

The next time we work on a major, updates, we will be much likely continue to work on a single version at a time, at least, as long as we we feel spread too thin, where we can only have a single active major version.

@mnajdova mnajdova requested a review from DiegoAndai March 18, 2024 15:38
@mnajdova
Copy link
Member Author

I wasn't sure if I should update the second part of https://mui.com/blog/2023-material-ui-v6-and-beyond/#material-ui-v7, where we mention the package. I left it for now.

Copy link
Member

@DiegoAndai DiegoAndai left a comment

Choose a reason for hiding this comment

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

  • Will he latest released version of the package still be available to users?
  • Should we keep the components' "Material Design 3 version" section? I think it's better to add a callout explaining that the material-next package is not being worked on while we wait to start working on v7. Simply removing it seems that it might scare people.

@mnajdova
Copy link
Member Author

Will he latest released version of the package still be available to users?

Yes, I don't plan to remove it from npm now. We are discontinuing the work on it.

Should we keep the components' "Material Design 3 version" section? I think it's better to add a callout explaining that the material-next package is not being worked on while we wait to start working on v7. Simply removing it seems that it might scare people.

I think it may be misleading to keep the demos, we do not want people to keep experimenting with this package, that was the sole purpose for adding these. Based on the number of downloads I wouldn't worry: https://npm-stat.com/charts.html?package=%40mui%2Fmaterial-next&from=2023-03-17&to=2024-03-17

@DiegoAndai
Copy link
Member

I think it may be misleading to keep the demos

Good point. Let's go ahead then.

We can leave a comment in #29345 explaining why those were removed.

I wasn't sure if I should update the second part of https://mui.com/blog/2023-material-ui-v6-and-beyond/#material-ui-v7, where we mention the package. I left it for now.

I would update it, under the same argument that we're removing the demos.

@mnajdova
Copy link
Member Author

I wasn't sure if I should update the second part of https://mui.com/blog/2023-material-ui-v6-and-beyond/#material-ui-v7, where we mention the package. I left it for now.

I would update it, under the same argument that we're removing the demos.

Fair enough, updated and I also updated the all components page to not show the MD3 tags anywhere.

@mnajdova mnajdova merged commit 6da671c into mui:master Mar 18, 2024
22 checks passed
@DiegoAndai
Copy link
Member

Fair enough, updated and I also updated the all components page to not show the MD3 tags anywhere.

cc: @danilo-leal

@oliviertassinari oliviertassinari changed the title [material-next] Drop the package [material-next] Drop the @mui/material-next package Dec 31, 2024
@oliviertassinari
Copy link
Member

oliviertassinari commented Dec 31, 2024

It looks like https://www.npmjs.com/package/@mui/material-next should have been deprecated. People got confused about it, e.g. https://x.com/michioxd/status/1873768653625368644.

Fixed:
SCR-20241231-mzqy

PR description updated to also clarify why.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants