A typical release goes like this:
The following steps must be proposed as a pull request.
-
Generate the changelog with
yarn release:changelog
The output must be prepended to the top levelCHANGELOG.md
yarn release:changelog --help
for more information. -
Clean the generated changelog, to match the format of https://github.com/mui/material-ui/releases.
-
Update the root
/package.json
's version -
yarn release:version
(🔔 manually remove^
from packages with prerelease version, eg.-alpha
) -
Open PR with changes and wait for review and green CI
-
Merge PR once CI is green and it has been approved
- checkout merge commit of the merged PR
yarn
yarn release:build
yarn release:publish
You need your 2FA device.yarn release:tag
Push the next branch on the release branch to deploy the documentation with the latest changes. It lives at https://material-ui.netlify.app/. Force push if necessary.
Note: if you don't have the material-ui-docs
remote already, you should add it with
git remote add material-ui-docs https://github.com/mui/material-ui-docs.git
yarn docs:deploy
Follow the instructions in https://mui-org.notion.site/Releases-7490ef9581b4447ebdbf86b13164272d.