diff --git a/docs/data/material/migration/upgrade-to-v7/upgrade-to-v7.md b/docs/data/material/migration/upgrade-to-v7/upgrade-to-v7.md new file mode 100644 index 00000000000000..ea4d7e7846291b --- /dev/null +++ b/docs/data/material/migration/upgrade-to-v7/upgrade-to-v7.md @@ -0,0 +1,25 @@ +# Upgrade to v7 + +
This guide explains how to upgrade from Material UI v6 to v7.
+ +## Start using the alpha release + +In the `package.json` file, change the package version from `latest` to `next`. + +```diff title="package.json" +-"@mui/material": "latest", ++"@mui/material": "next", +``` + +Using `next` ensures your project always uses the latest v7 pre-releases. +Alternatively, you can also target and fix it to a specific version, for example, `7.0.0-alpha.0`. + +## Breaking changes + +Since v7 is a new major release, it contains some changes that affect the public API. +The steps you need to take to migrate from Material UI v6 to v7 are described below. + +:::info +This list is a work in progress. +Expect updates as new breaking changes are introduced. +::: diff --git a/docs/data/material/pages.ts b/docs/data/material/pages.ts index 0d40d59337f672..b0c4e98270a25d 100644 --- a/docs/data/material/pages.ts +++ b/docs/data/material/pages.ts @@ -297,6 +297,16 @@ const pages: MuiPage[] = [ pathname: '/material-ui/migration/pickers-migration', title: 'Migration from @material-ui/pickers', }, + { + pathname: '/material-ui/migration/v7', + subheader: 'Upgrade to v7', + children: [ + { + pathname: '/material-ui/migration/upgrade-to-v7', + title: 'Upgrade to v7: getting started', + }, + ], + }, { pathname: '/material-ui/migration/v6', subheader: 'Upgrade to v6', diff --git a/docs/data/system/migration/upgrade-to-v7/upgrade-to-v7.md b/docs/data/system/migration/upgrade-to-v7/upgrade-to-v7.md new file mode 100644 index 00000000000000..bed77a1c3f3b90 --- /dev/null +++ b/docs/data/system/migration/upgrade-to-v7/upgrade-to-v7.md @@ -0,0 +1,25 @@ +# Upgrade to v7 + +This guide explains how to upgrade from MUI System v6 to v7.
+ +## Start using the alpha release + +In the `package.json` file, change the package version from `latest` to `next`. + +```diff title="package.json" +-"@mui/system": "latest", ++"@mui/system": "next", +``` + +Using `next` ensures your project always uses the latest v7 pre-releases. +Alternatively, you can also target and fix it to a specific version, for example, `7.0.0-alpha.0`. + +## Breaking changes + +Since v7 is a new major release, it contains some changes that affect the public API. +The steps you need to take to migrate from MUI System v6 to v7 are described below. + +:::info +This list is a work in progress. +Expect updates as new breaking changes are introduced. +::: diff --git a/docs/data/system/pages.ts b/docs/data/system/pages.ts index 67d5508f82b52e..81494b78fa5693 100644 --- a/docs/data/system/pages.ts +++ b/docs/data/system/pages.ts @@ -46,6 +46,10 @@ const pages: readonly MuiPage[] = [ pathname: '/system/migration', title: 'Migration', children: [ + { + pathname: '/system/migration/upgrade-to-v7', + title: 'Upgrade to v7', + }, { pathname: '/system/migration/migrating-to-v6', title: 'Migrating to v6', diff --git a/docs/pages/material-ui/migration/upgrade-to-v7.js b/docs/pages/material-ui/migration/upgrade-to-v7.js new file mode 100644 index 00000000000000..36104b9deb519c --- /dev/null +++ b/docs/pages/material-ui/migration/upgrade-to-v7.js @@ -0,0 +1,7 @@ +import * as React from 'react'; +import MarkdownDocs from 'docs/src/modules/components/MarkdownDocs'; +import * as pageProps from 'docs/data/material/migration/upgrade-to-v7/upgrade-to-v7.md?muiMarkdown'; + +export default function Page() { + return