[WIP][docs] Add migration for v6

[siriwatknp]

Blocked by:

• [ ] CSS theme variables docs
• [ ] Codemod for deprecating system props (this could be useful)
• [ ] Decide on the minimum React & TypeScript version

---

• [ ] I have followed (at least) the PR section of the contributing guide.

[mui-bot]

Netlify deploy preview

• docs/data/material/migration/migrating-to-v6/migrating-to-v6.md
• docs/data/material/migration/migrating-to-v6/migration-css-theme-variables.md
• docs/data/system/migration/migrating-to-v6/migrating-to-v6.md

Bundle size report

No bundle size changes (Toolpad) No bundle size changes

Generated by :no_entry_sign: dangerJS against bfaa89bd20abb8915df6be135744f35f1dd24a8b

[DiegoAndai]

Hey @siriwatknp! I merged https://github.com/mui/material-ui/pull/42194. I'll complete the deprecations section as soon as possible.

[mnajdova]

Decide on the minimum React & TypeScript version

On React, we decided on React 17

[DiegoAndai]

@siriwatknp I updated the PR after some breaking changes were added to the migration guide in other PRs. I haven't forgotten about adding the components and componentsProps to the deprecation section 😅 I just haven't had time yet, but I'll get to it.

[DiegoAndai]

are we not mentioning React 19 as a v6 highlight?

Not ready yet so I think we can add it when it is

[DiegoAndai]

@siriwatknp I added the section about components and componentsProps deprecations.

As discussed, the *Component, *Props, and composed classes deprecations will continue to be added after v6 release, so I'm not mentioning them here.

[siriwatknp]

@danilo-leal @samuelsycamore I think this is ready as the first batch of the migration guide.

[mapache-salvaje]

I missed the chance to review but this is looking great! Nice job on the migration doc!

[DiegoAndai]

@samuelsycamore I think we can/should review the whole migration doc structure and writing before the stable release. When all content is ready. This way, we avoid spamming you with notifications.

[mapache-salvaje]

I appreciate that @DiegoAndai ! I will be most useful in this process as an alpha tester and copyeditor, so it does make the most sense to loop me in at the very end. 👍