NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #2936 most downloaded on npm
Internal package to track number of downloads of our design system libraries.
Last release 1 months ago
27 Aug 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
204 releases · first in 2022
One column per quarter.
<!-- generated comparing v5.15.17..master --> _May 14, 2024_
<!-- generated comparing v5.15.17..master --> May 14, 2024
A big thanks to the 5 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.15.18selected class in ToggleButtonGroupClasses type (@tarunrajput) (#42250) @github-actions[bot]All contributors of this release in alphabetical order: @arthurbalduini, @oliviertassinari, @samuelsycamore, @TahaRhidouani, @tarunrajput
A big thanks to the 4 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
May 8, 2024
A big thanks to the 4 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
@mui/material@5.15.17All contributors of this release in alphabetical order: @github-actions[bot], @joserodolfofreitas, @oliviertassinari, @siriwatknp
A big thanks to the 8 contributors who made this release possible. Here are some highlights ✨: This release was mostly about 🐛 bug fixes and 📚 documen
A big thanks to the 8 contributors who made this release possible. Here are some highlights ✨: This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
@mui/material@5.15.16muiName property TypeScript error (@EyaOuenniche) (#41786) @github-actions[bot]next -> master (#41742) @aarongarciahDesign Engineer - X role (#42014) @DanailHAll contributors of this release in alphabetical order: @aarongarciah, @alexfauquette, @DanailH, @DiegoAndai, @github-actions[bot], @JCQuintas, @mnajdova, @oliviertassinari
A big thanks to the 7 contributors who made this release possible. Here are some highlights ✨: This release was mostly about 🐛 bug fixes and 📚 documen
A big thanks to the 7 contributors who made this release possible. Here are some highlights ✨: This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
@mui/material@5.15.15options prop even if loading is true (#41677) @ZeeshanTamboli@mui/system@5.15.15valueLabelFormat from restricted values demo so that the tooltip thumb label displays the same as the value text (#41679) @ZeeshanTamboliAll contributors of this release in alphabetical order: @aarongarciah, @bharatkashyap, @cherniavskii, @danilo-leal, @mnajdova, @oliviertassinari, @ZeeshanTamboli
A big thanks to the 15 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
Mar 19, 2024
A big thanks to the 15 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
@mui/material@5.15.14@pigment-css/react@0.0.3pigment-css/nextjs-plugin@0.0.3All contributors of this release in alphabetical order: @bharatkashyap, @brijeshb42, @cherniavskii, @cipherlogs, @danilo-leal, @DiegoAndai, @EyaOuenniche, @Janpot, @jherr, @michaldudak, @mnajdova, @oliviertassinari, @sai6855, @siriwatknp, @zanivan
<!-- generated comparing v5.15.12..master -->
<!-- generated comparing v5.15.12..master -->
Mar 13, 2024
A big thanks to the 18 contributors who made this release possible. Here are some highights ✨
@mui/material@5.15.13slots and slotProps type to theme (#41324) @sai6855freeSolo mode even when there are no options, causing style problems (#41300) @rakeshmusturipaperChannel token (#41447) @siriwatknp@mui/system@5.15.13@mui/utils@5.15.13@mui/codemod@5.15.13@mui/base@5.0.0-beta.39FormControlOwnerState type from index (#41287) @michaeldfoley@pigment-css/react@0.0.2keyframes serialize styles error (#41395) @siriwatknp<b> appearing in notifications (#41390) @peterwangscAll contributors of this release in alphabetical order: @alexfauquette, @anle9650, @brijeshb42, @CGNonofr, @cipherlogs, @danilo-leal, @jwithington, @Janpot, @michaeldfoley, @michaldudak, @mnajdova, @oliviertassinari, @peterwangsc, @rakeshmusturi, @sai6855, @siriwatknp, @zanivan, @ZeeshanTamboli
<!-- 49 -->[Alert] Deprecate composed classes (#40688) @DiegoAndai
Mar 5, 2024
A big thanks to the 21 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
@mui/material@5.15.12large size added in type (#34909) @smoxdeleteIconColorPrimary and deleteIconColorSecondary class descriptions (#41231) @sai6855@mui/system@5.15.12object intersection from CSS Fallback (#41271) @siriwatknp@mui/joy@5.0.0-beta.30useLocalStorageState hook from Toolpad (#41096)" @oliviertassinariReact Engineer - xCharts to Next roles section (#41368) @DanailHAll contributors of this release in alphabetical order: @alexfauquette, @atomiks, @brijeshb42, @DanailH, @danilo-leal, @DiegoAndai, @divyammadhok, @Janpot, @lhilgert9, @matystroia, @michaldudak, @michelengelen, @mj12albert, @oliviertassinari, @prakhargupta1, @PunitSoniME, @sai6855, @siriwatknp, @smox, @zanivan, @ZeeshanTamboli
[Alert] Deprecate components and componentsProps props (#40681) @DiegoAndai
A big thanks to the 26 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
@mui/material@5.15.11@mui/material-nextjs@5.15.11@mui/system@5.15.11@mui/codemod@5.15.11@mui/utils@5.15.11useLocalStorageState hook from Toolpad (#41096) @Janpot@mui/base@5.0.0-beta.37@mui/lab@5.0.0-alpha.164/base-ui-2024-plans/ page (#41171) @oliviertassinariexperimental.cpus to control amount of export workers in Next.js (#41132) @Janpot@mui/base dev dependency from Base UI workspace (#41216) @ZeeshanTamboliOmit on types with conditional properties (#41033) @flaviendelangleextendTheme for creating a zero-runtime theme (#40897) @siriwatknpAll contributors of this release in alphabetical order: @alexfauquette, @brijeshb42, @danilo-leal, @DiegoAndai, @dpertsin, @flaviendelangle, @gitstart, @gregberge, @harrydigos, @Janpot, @justintoman, @khgiddon, @KirankumarAmbati, @LukasTy, @michaldudak, @mnajdova, @nikosgavalas, @oliviertassinari, @PaulKristoffersson, @Rishi556, @rluzists1, @sai6855, @samuelsycamore, @siriwatknp, @zanivan, @ZeeshanTamboli
[Avatar] Add props deprecation with a codemod (#40853) @siriwatknp
Feb 12, 2024
A big thanks to the 8 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
@mui/material@5.15.10@mui/joy@5.0.0-beta.28disabled prop priority when inside button group (#41000) @Smileekchildren prop so docgen tools don't parse it as HTML (#40992) @millerizedcopyFiles script to reuse in MUI X repo (#40970) @cherniavskii@ignore (#41009) @cherniavskiiAll contributors of this release in alphabetical order: @cherniavskii, @danilo-leal, @joserodolfofreitas, @millerized, @oliviertassinari, @sai6855, @siriwatknp, @Smileek
<!-- 05 -->[material-ui][docs] Migrating from deprecated apis follow up (#40981) @DiegoAndai
Feb 8, 2024
A big thanks to the 7 contributors who made this release possible. Here are some highlights ✨:
@mui/material peerDependencies.@mui/material@5.15.9@mui/base@5.0.0-beta.36@mui/system@5.15.9ReadonlyArray for CSS related types (#40972) @siriwatknplight prop removal (#40947) @sai6855All contributors of this release in alphabetical order: @brijeshb42, @DiegoAndai, @Janpot, @oliviertassinari, @RaghavenderSingh, @sai6855, @siriwatknp
<!-- 21 -->[material-ui] Add deprecations migration guide (#40767) @DiegoAndai
Feb 6, 2024
A big thanks to the 17 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.15.8@mui/codemod@5.15.8findComponentJSX util (#40855) @sai6855@mui/system@5.15.8theme.styleOverrides (#40690) @siriwatknpcreateUseThemeProps call (#40885) @siriwatknp@mui/base@5.0.0-beta.34hostElementName prop to improve SSR (#40507) @mj12albert<meta name="viewport" /> @oliviertassinariAll contributors of this release in alphabetical order: @adebiyial, @brijeshb42, @danilo-leal, @DiegoAndai, @hsmtkk, @Janpot, @michaldudak, @mj12albert, @mnajdova, @oliviertassinari, @rluzists1, @romgrk, @sai6855, @siriwatknp, @Smileek, @xuhdev, @zanivan
<!-- 38 -->Add accordion props deprecation (#40771) @siriwatknp
<!-- generated comparing v5.15.6..master -->
Jan 31, 2024
A big thanks to the 21 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
@mui/material@5.15.7displayEmpty (#40865) @ZeeshanTambolichildren is empty string or boolean (#40766) @mirus-ua@mui/codemod@5.15.7@mui/system@5.15.7applyStyles() to theme (#40667) @siriwatknptheme.applyStyles in the demo app (#40787) @siriwatknpuseThemeProps processor (#40648) @siriwatknp@mui/utils@5.15.7clearTimeout calls (#39060) @romgrk@mui/base@5.0.0-beta.34@mui/joy@5.0.0-beta.25SupportedColorScheme (#40776) @Nikhilh26@mui/lab@5.0.0-alpha.163value (#40829) @srinidhi9831React Engineer - X into the future roles section (#40867) @DanailHmissingKeyGenerator do no longer exist (#40830) @oliviertassinari@types/markdown-to-jsx package from docs (#40828) @ZeeshanTamboli@slack/web-api package (#40840) @ZeeshanTamboliPropTypes.object (#40774) @flaviendelangleAll contributors of this release in alphabetical order: @alexfauquette, @colmtuite, @danilo-leal, @DiegoAndai, @EyaOuenniche, @flaviendelangle, @Janpot, @Jaswanth-Sriram-Veturi, @joserodolfofreitas, @michaldudak, @mirus-ua, @mnajdova, @mohamedsaiedd, @Nikhilh26, @oliviertassinari, @romgrk, @sai6855, @siriwatknp, @srinidhi9831, @zanivan, @ZeeshanTamboli
<!-- 06 -->[PaginationItem] Deprecate classes for v6 (#40673) @sai6855
Jan 22, 2024
A big thanks to the 17 contributors who made this release possible. Here are some highlights ✨: This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
@mui/material@5.15.6rowsPerPageOptions prop (#40481) @pcorpet@mui/base@5.0.0-beta.33@mui/system@5.15.6@mui/icons-material@5.15.6All contributors of this release in alphabetical order: @alexfauquette, @anle9650, @ANUGLYPLUGIN, @brijeshb42, @danilo-leal, @devhik0, @DiegoAndai, @DonikaV, @joserodolfofreitas, @michaldudak, @mj12albert, @mnajdova, @mohamedsaiedd, @oliviertassinari, @pcorpet, @sai6855, @zanivan
<!-- 42 -->[Accordion] Deprecate \*Props props and classes for v6 (#40418) @DiegoAndai
<!-- generated comparing v5.15.4..master -->
Jan 17, 2024
A big thanks to the 18 contributors who made this release possible. Here are some highlights ✨:
base- (#40205) @michaldudak@mui/material@5.15.5iconMapping and severity props (#40551) @2metres@mui/material-next@6.0.0-alpha.118ButtonGroup (#40124) @lhilgert9@mui/base@5.0.0-beta.32base- (#40205) @michaldudakThe class prefix of Base UI components have been changed from Mui- to base-. This only affects codebases that uses class names verbatim, i.e. not exposed by JS objects such as buttonClasses, but as plain strings or in CSS stylesheets (.MuiButton.root)
To adapt your code to the new pattern:
.Mui([A-Z][A-Za-z]*)- with .base-$1- (so MuiButton-root becomes base-Button-root, etc.),.Mui-([a-z]*) with .base--$1 (so Mui-disabled becomes base--disabled, etc.).@mui/joy@5.0.0-beta.23@mui/codemod@5.15.5json files to be transformed (#40536) @ZeeshanTamboli@mui/lab@5.0.0-alpha.161@mui/material peer dependency version (#40528) @ZeeshanTamboli@mui/material-nextjs@5.15.5@mui/system@5.15.5State interface from Consecutive Snackbars demo (#40410)
@zinoromandocs:link-check (#40547) @samuelsycamorerun command to deploy docs (#40513) @siriwatknpAll contributors of this release in alphabetical order: @2metres, @aacevski, @brijeshb42, @danilo-leal, @DiegoAndai, @josh-feldman, @Kamino0, @lhilgert9, @maakcode, @michaldudak, @oliviertassinari, @petrovmiroslav, @sai6855, @samuelsycamore, @siriwatknp, @zanivan, @ZeeshanTamboli, @zinoroman
A big thanks to the 22 contributors who made this release possible. Here are some highlights:
Jan 10, 2024
A big thanks to the 22 contributors who made this release possible. Here are some highlights:
@mui/material@5.15.4@mui/material-nextjs@5.15.4@mui/icons-material@5.15.4@mui/system@5.15.4@mui/utils@5.15.4isPlainObject to work across realm (#39981) @brijeshb42@mui/base@5.0.0-beta.31@mui/joy@5.0.0-beta.22JoyToggleButtonGroup to extendTheme's components type export (#40407) @RiceCrispmui-x dependency resolving (#40257) @LukasTyt command (#40430) @michaldudakAll contributors of this release in alphabetical order: @aacevski, @alexfauquette, @anle9650, @brijeshb42, @danilo-leal, @DiegoAndai, @iamsaumya, @illume, @Janpot, @LukasTy, @Methuselah96, @michaldudak, @mj12albert, @nicegamer7, @oliviertassinari, @renovate[bot], @RiceCrisp, @sai6855, @samuelsycamore, @savalaram-redkar, @siriwatknp, @zanivan
A big thanks to the 11 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
Jan 3, 2024
A big thanks to the 11 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
@mui/material-nextjs@5.15.3@mui/base@5.0.0-beta.30@mui/lab@5.0.0-alpha.159@mui/material-next@6.0.0-alpha.116All contributors of this release in alphabetical order: @aacevski, @anle9650, @danilo-leal, @DiegoAndai, @Kamino0, @lhilgert9, @michaldudak, @oliviertassinari, @sai6855, @siriwatknp, @Super-Kenil
A big thanks to the 13 contributors who made this release possible. Here are some highlights ✨:
Dec 25, 2023
A big thanks to the 13 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.15.1@mui/system@5.15.1@mui/base@5.0.0-beta.29@mui/material-next@6.0.0-alpha.115All contributors of this release in alphabetical order: @adamhylander, @anle9650, @danilo-leal, @DiegoAndai, @Kimzify, @michaldudak, @mnajdova, @muazaqdas, @oliviertassinari, @sai6855, @samuelsycamore, @siriwatknp, @ZeeshanTamboli
A big thanks to the 15 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
Dec 19, 2023
A big thanks to the 15 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
@mui/material@5.15.1slots and slotProps (#33797) @pratikkarad@mui/joy@5.0.0-beta.19htmlFor and id attributes not functioning properly for form labels (#40180) @ReaZzy@mui/styled-engine-sc@6.0.0-alpha.9theme being of type any (#40200) @mnajdovamui-tiptap for rich text (#40216) @sjdemartiniAll contributors of this release in alphabetical order: @danilo-leal, @gitstart, @MBilalShafi, @mbrookes, @mnajdova, @oliviertassinari, @possibilities, @pratikkarad, @qiweiii, @ReaZzy, @s8990, @sai6855, @sjdemartini, @zanivan, @ZeeshanTamboli
<!-- generated comparing v5.14.20..master -->
<!-- generated comparing v5.14.20..master -->
Dec 11, 2023
A big thanks to the 15 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.15.0@mui/material-nextjs@5.15.0@mui/material-next@6.0.0-alpha.113ButtonGroup files to ts (#39794) @lhilgert9@mui/icons-material@5.15.0@mui/base@5.0.0-beta.27@mui/joy@5.0.0-beta.18@mui/lab@5.0.0-alpha.156All contributors of this release in alphabetical order: @abreel, @alexfauquette, @anle9650, @blakenetz, @danilo-leal, @EloB, @lhilgert9, @mbrookes, @mikailaread, @mj12albert, @mnajdova, @sai6855, @siriwatknp, @zanivan, @ZeeshanTamboli
A big thanks to the 14 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
Dec 5, 2023
A big thanks to the 14 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
@mui/material-next@6.0.0-alpha.112CircularProgress (#39825) @lhilgert9sm screens (#40049) @DiegoAndaiAll contributors of this release in alphabetical order: @alexfauquette, @anle9650, @caweidmann, @danilo-leal, @DiegoAndai, @fzaninotto, @Janpot, @lhilgert9, @michaldudak, @mnajdova, @oliviertassinari, @REX500, @samuelsycamore, @zanivan
A big thanks to the 18 contributors who made this release possible. Here are some highlights ✨:
Nov 29, 2023
A big thanks to the 18 contributors who made this release possible. Here are some highlights ✨:
material-next package (#39807) @lhilgert9@mui/material@5.14.19onChange type from SelectInputProps (#39891) @ZeeshanTamboli@mui/base@5.0.0-beta.25numberInputReducer (#38723) @mj12albert@mui/joy@5.0.0-beta.16@mui/system@5.14.19@mui/types@7.2.10PartiallyRequired type (#39939) @lhilgert9@mui/material-next@6.0.0-alpha.111LinearProgress (#39807) @lhilgert9Switch to material next (#39887) @lhilgert9All contributors of this release in alphabetical order: @avikalpg, @brijeshb42, @cherniavskii, @danilo-leal, @DarhkVoyd, @dhaub-exelixis, @DiegoAndai, @flaviendelangle, @islandryu, @joserodolfofreitas, @lhilgert9, @mj12albert, @mnajdova, @oliviertassinari, @sadik-malik, @sai6855, @zanivan, @ZeeshanTamboli
<!-- generated comparing v5.14.17..master -->
<!-- generated comparing v5.14.17..master -->
Nov 14, 2023
A big thanks to the 14 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.14.18defaultMuiPrevented to onKeyDown type (#39820) @sai6855slotProps pattern for the actions and the select slots (#39353) @anle9650@mui/joy@5.0.0-beta.15Stepper component (#39688) @siriwatknp@mui/material-next@6.0.0-alpha.110ButtonGroup to material next (#39739) @lhilgert9CircularProgress files to ts (#39791) @lhilgert9LinearProgress files to ts (#39793) @lhilgert9LinearProgress to material next (#39779) @lhilgert9CircularProgress to material next (#39780) @lhilgert9CssBaseline to integration with Material UI page (#39790) @swilliancAll contributors of this release in alphabetical order: @anle9650, @axelbostrom, @danilo-leal, @joserodolfofreitas, @lhilgert9, @michaldudak, @mj12albert, @mnajdova, @oliviertassinari, @sai6855, @siriwatknp, @swillianc, @zanivan, @ZeeshanTamboli
A big thanks to the 12 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
Nov 6, 2023
A big thanks to the 12 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
@mui/material@5.14.17sx type to input and root slot (#39569) @sai6855@mui/joy@5.0.0-beta.14Button is not immediate children (#39571) @sai6855@mui/base@5.0.0-beta.23@mui/material-next@6.0.0-alpha.109@mui/lab@5.0.0-alpha.152All contributors of this release in alphabetical order: @alexfauquette, @brijeshb42, @chiahao, @danilo-leal, @hasdfa, @megos, @michaldudak, @mj12albert, @oliviertassinari, @sai6855, @samuelsycamore, @ZeeshanTamboli
A big thanks to the 19 contributors who made this release possible. Here are some highlights ✨:
Oct 31, 2023
A big thanks to the 19 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.14.16@mui/base@5.0.0-beta.22@mui/joy@5.0.0-beta.13MenuList demo (#39459) @sai6855multiple options (#39454) @sai6855@mui/material-next@6.0.0-alpha.108@mui/styles docs and discourage users from installing it (#39644) @samuelsycamorecolor="black" from Next.js App Router layout (#39577) @samuelsycamore@types/loader-utils package from zero-next-plugin (#39609) @ZeeshanTamboliDesign Engineer - xGrid role (#39375) @DanailHAll contributors of this release in alphabetical order: @alexfauquette, @Best-Sardar, @DanailH, @danilo-leal, @DiegoAndai, @emamoah, @gitstart, @Janpot, @jcoyle37, @mj12albert, @mnajdova, @Nkzn, @oliviertassinari, @Popppins, @sai6855, @samuelsycamore, @siriwatknp, @zanivan, @ZeeshanTamboli
<!-- generated comparing v5.14.14..master -->
<!-- generated comparing v5.14.14..master -->
Oct 24, 2023
A big thanks to the 17 contributors who made this release possible.
@mui/material@5.14.15fullWidth to toggleButtonClasses and toggleButtonGroupClasses (#39536) @Semigradsky@mui/base@5.0.0-beta.21@mui/material-next@6.0.0-alpha.107@mui/joy@5.0.0-beta.12userSelect: none only when it's a button (#39486) @mwskwong@mui/lab@5.0.0-alpha.150@mui/zero-runtime@0.0.1-alpha.0@mui/zero-vite-plugin@0.0.1-alpha.0useCallback by useRef in useEventCallback (#39078) @romgrkAll contributors of this release in alphabetical order: @alexfauquette, @Best-Sardar, @brijeshb42, @danilo-leal, @DiegoAndai, @Evan151, @gitstart, @hjalti-lifekeys, @mj12albert, @mnajdova, @mwskwong, @oliviertassinari, @romgrk, @Semigradsky, @siriwatknp, @VadimZvf, @zanivan
<!-- generated comparing v5.14.13..master -->
<!-- generated comparing v5.14.13..master -->
Oct 17, 2023
A big thanks to the 24 contributors who made this release possible. Here are some highlights ✨: This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
@mui/material@5.14.14renderSurplus prop (#39283) @uuxxxTheme interface when applied directly (#39404) @Semigradskytype parameter of getItemAriaLabel prop (#39390) @Simer13@mui/base@5.0.0-beta.20@mui/material-next@6.0.0-alpha.106@mui/joy@5.0.0-beta.11marker prop (#39313) @siriwatknp@mui/icons-material@5.14.14@mui/system@5.14.14@mui/styled-engine-sc@6.0.0-alpha.2kbd tag styles (#39397) @danilo-lealAll contributors of this release in alphabetical order: @adrienbrault, @alexfauquette, @Best-Sardar, @BreakBB, @brijeshb42, @chhawinder, @christophermorin, @codewithrabeeh, @danilo-leal, @DarhkVoyd, @devuser200, @michaldudak, @mnajdova, @oliviertassinari, @parikshitadhikari, @samuelsycamore, @Semigradsky, @Simer13, @siriwatknp, @TheNatkat, @uuxxx, @vineetjk, @zanivan, @ZeeshanTamboli
A big thanks to the 22 contributors who made this release possible. Here are some highlights ✨:
Oct 10, 2023
A big thanks to the 22 contributors who made this release possible. Here are some highlights ✨:
styled-components v6 (#39042) @mnajdova@mui/material@5.14.13styleOverrides Popper type in theme (#39154) @axelbostrom@mui/base@5.0.0-beta.19@mui/material-next@6.0.0-alpha.105@mui/joy@5.0.0-beta.10type=button to clear button (#39263) @brijeshb42@mui/styled-engine-sc@6.0.0-alpha.1styled-components v6 (#39042) @mnajdovaerror prop from input validation demo (#39280) @sai6855sx prop callback (#39259) @3xp10it3rAll contributors of this release in alphabetical order: @3xp10it3r, @alexfauquette, @ARJ2160, @atharva3333, @axelbostrom, @Bestwebdesign, @brijeshb42, @chirag3003, @danilo-leal, @DarhkVoyd, @DiegoAndai, @gugudwt, @mbrookes, @michaldudak, @mj12albert, @mnajdova, @oliviertassinari, @sai6855, @samuelsycamore, @siriwatknp, @ValkonX33, @ZeeshanTamboli
A big thanks to the 17 contributors who made this release possible. Here are some highlights ✨:
A big thanks to the 17 contributors who made this release possible. Here are some highlights ✨:
"button" role, then you'll have to change it to use the "combobox" role instead@mui/material@5.14.12button type (#39189) @sai6855@mui/system@5.14.12variants in the styled() util (#39073) @mnajdova@mui/base@5.0.0-beta.18@mui/material-next@6.0.0-alpha.104@mui/joy@5.0.0-beta.9gap property (#39147) @siriwatknpGlobalStyles (#39278) @siriwatknpAutocomplete github label demo to actual github label dropdown (#39228) @sai6855Box with Stack in applicable demos (#39174) @sai6855React Engineer - xCharts Ashby link (#39172) @DanailHAll contributors of this release in alphabetical order: @alexfauquette, @brijeshb42, @DanailH, @danilo-leal, @DiegoAndai, @Erik-McKelvey, @Janpot, @mj12albert, @mnajdova, @oliviertassinari, @romgrk, @sai6855, @Semigradsky, @siriwatknp, @xulingzhihou, @zanivan, @ZeeshanTamboli
A big thanks to the 23 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
Sep 26, 2023
A big thanks to the 23 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
@mui/material@5.14.11AutocompleteValue to make it available from path import (#38638) @vadimka123@mui/utils@5.14.11isMuiElement util (#38129) @sai6855@mui/base@5.0.0-beta.17@mui/joy@5.0.0-beta.8JoyDrawer in theme components (#39074) @Studio384@mui/material-next@6.0.0-alpha.103@mui/lab@5.0.0-alpha.146use-count-up integration with the Circular Progress (#38952) @anon-phantomuseEnhancedEffect (#39035) @JanpotAll contributors of this release in alphabetical order: @alexfauquette, @alisasanib, @anle9650, @anon-phantom, @DanailH, @danilo-leal, @DiegoAndai, @flaviendelangle, @gitstart, @Janpot, @jergason, @maheshguntur, @michaldudak, @mikailaread, @mj12albert, @mnajdova, @oliviertassinari, @sai6855, @Studio384, @tebersefa, @vadimka123, @zanivan, @ZeeshanTamboli
A big thanks to the 16 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
Sep 18, 2023
A big thanks to the 16 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
@mui/material@5.14.10@mui/utils@5.14.10@mui/base@5.0.0-beta.16useControlled (#38757) @sai6855@mui/joy@5.0.0-beta.7TablePagination to the API components list (#38486) @MonstraGInfoCard component (#38987) @danilo-lealAll contributors of this release in alphabetical order: @alisasanib, @brijeshb42, @danilo-leal, @DarhkVoyd, @DiegoAndai, @Janpot, @mateuseap, @Methuselah96, @michaldudak, @mj12albert, @mnajdova, @MonstraG, @oliviertassinari, @sai6855, @siriwatknp, @ZeeshanTamboli
<!-- 09 -->Add TypeScript deprecations (#38833) @oliviertassinari
Sep 13, 2023
A big thanks to the 18 contributors who made this release possible. Here are some highlights ✨:
Drawer component to Joy UI (#38169) @mnajdovaButtonGroup component now styles button elements within it correctly (#38520) @ZeeshanTamboli@mui/material@5.14.9@mui/base@5.0.0-beta.15disableEnforceFocus behavior (#38816) @mnajdova@mui/joy@5.0.0-beta.6DialogActions, DialogTitle and DialogContent (#38382) @siriwatknpvariant and color classes (#38814) @sai6855@mui/lab@5.0.0-alpha.144@mui/x-tree-view dependency (#38822) @flaviendelangle@mui/system@5.14.9@mui/zero-vite-plugin@0.0.1-alpha.0Typography props (#38856) @sai6855All contributors of this release in alphabetical order: @brentertz, @brijeshb42, @danilo-leal, @DiegoAndai, @dvkam, @flaviendelangle, @Janpot, @LadyBluenotes, @michaldudak, @michelengelen, @mj12albert, @mnajdova, @oliviertassinari, @sai6855, @samuelsycamore, @siriwatknp, @zanivan, @ZeeshanTamboli
A big thanks to the 25 contributors who made this release possible.
Sep 5, 2023
A big thanks to the 25 contributors who made this release possible.
@mui/material@5.14.8Slider InputLabel InputBase Radio (#38401) @sai6855ref type (#38717) @ZeeshanTamboli@mui/base@5.0.0-beta.14@mui/joy@5.0.0-beta.5ratio prop description (#38743) @sai6855@mui/lab@5.0.0-alpha.143@mui/system@5.14.8mergeBreakpointsInOrder function (#38749) @imevancoverlay prop demo (#38702) @danilo-leal<!-- 43 -->[core] Re-add nx and setup build caching (#38752) @brijeshb42
<!-- 41 -->[core] Remove dead code seoTitle @oliviertassinari
<!-- 40 -->[core] Use immutable refs (#38762) @oliviertassinari
<!-- 39 -->[core] Rework typescript-to-proptypes to share the AST parsing with parseStyles (#38517) @flaviendelangle
<!-- 38 -->[core] Fix CI @oliviertassinari
<!-- 37 -->[core] Remove unnecessary @types/webpack package (#38720) @ZeeshanTamboli
<!-- 36 -->[core] Remove duplicate prop @oliviertassinari
<!-- 22 -->[docs-infra] Fix mobile display in CodeSandbox (#38767) @oliviertassinari
<!-- 21 -->[docs-infra] Remove legacy GA (#37579) @alexfauquette
<!-- 20 -->[docs-infra] Fix emotion :first-child console log (#38690) @oliviertassinari
<!-- 19 -->[docs-infra] Fix leaking callout content (#38712) @danilo-leal
<!-- 18 -->[docs-infra] Remove emoji from callouts (#38694) @danilo-leal
<!-- 04 -->[website] Fix out of date discount value @oliviertassinari
<!-- 03 -->[website] Fix out-of-date label on Toolpad (#38744) @bharatkashyap
<!-- 02 -->[website] Fine-tune branding buttons box shadows (#38731) @danilo-leal
<!-- 01 -->[website] Fix pricing table style (#38681) @alexfauquette
All contributors of this release in alphabetical order: @alexfauquette, @alisasanib, @amal-qb, @anle9650, @anon-phantom, @bharatkashyap, @brijeshb42, @christophermorin, @danilo-leal, @flaviendelangle, @imevanc, @jyash97, @mbrookes, @michaldudak, @mj12albert, @oliviertassinari, @omriklein, @pcorpet, @rajgop1, @ruflair, @sai6855, @siriwatknp, @szalonna, @zanivan, @ZeeshanTamboli
A big thanks to the 11 contributors who made this release possible. This release focuses primarily on 🐛 bug fixes, 📚 documentation, and ⚙️ infrastruct
Aug 29, 2023
A big thanks to the 11 contributors who made this release possible. This release focuses primarily on 🐛 bug fixes, 📚 documentation, and ⚙️ infrastructure improvements.
@mui/material@5.14.7disabled (#38611) @mj12albert@mui/base@5.0.0-beta.13@mui/zero-runtime@0.0.1-alpha.1loading prop documentation (#38625) @sai6855key prop JSDoc description in Snackbar component code correctly (#38603) @jaydenseric@types/jsdom (#38657) @renovate[bot]All contributors of this release in alphabetical order: @brijeshb42, @danilo-leal, @DerTimonius, @DiegoAndai, @Janpot, @jaydenseric, @mj12albert, @michaldudak, @oliviertassinari, @renovate[bot], @sai6855, @VishruthR
🚀 Added the Popup component to Base UI (#37960) @michaldudak It's intended to replace the Popper component, which uses the deprecated Popper JS librar…
A big thanks to the 21 contributors who made this release possible. Here are some highlights ✨:
material-next (#38319) @DiegoAndai @mj12albert@mui/material@5.14.6root class to SelectClasses (#38424) @sai6855@mui/base@5.0.0-beta.12@mui/joy@5.0.0-beta.3required prop (#38167) @siriwatknp@mui/material-next@6.0.0-alpha.98@mui/zero-runtime@0.0.1-alpha.0fullWidth prop description for the Input (#38545) @0xturneronClose API docs (#38273) @johnmatthiggins@material-ui/ aliases from regression test webpack config (#38574) @ZeeshanTamboliAll contributors of this release in alphabetical order: @0xturner, @alexfauquette, @alisasanib, @brijeshb42, @codersjj, @cristianmacedo, @danilo-leal, @DiegoAndai, @GresilleSiffle, @homerchen19, @johnmatthiggins, @michaldudak, @mj12albert, @mnajdova, @mwskwong, @oliviertassinari, @sai6855, @samuelsycamore, @siriwatknp, @zanivan, @ZeeshanTamboli
A big thanks to the 17 contributors who made this release possible. Here are some highlights ✨:
Aug 14, 2023
A big thanks to the 17 contributors who made this release possible. Here are some highlights ✨:
prepareForSlot utility (#38138)@mui/material@5.14.5onClick on root element (#38072) @LukasTy@mui/codemod@5.14.5@mui/joy@5.0.0-beta.2FormHelperText icon color (#38387) @TheNatkatkeepMounted prop (#38293) @decadef20@mui/base@5.0.0-beta.11useModal hook (#38187) @mnajdovaprepareForSlot util (#38138) @mnajdovaFileUpload demo (#38420) @sai6855aria-labels in extended variant examples of Floating Action Button (#37170) @ashleykolodziejGetStartedButtons component (#38256) @danilo-lealAll contributors of this release in alphabetical order: @alexfauquette, @ashleykolodziej, @danilo-leal, @decadef20, @DiegoAndai, @flaviendelangle, @LukasTy, @michaldudak, @mj12albert, @mnajdova, @nithins1, @oliviertassinari, @richbustos, @sai6855, @samuelsycamore, @TheNatkat, @zanivan
A big thanks to the 18 contributors who made this release possible. Here are some highlights ✨:
Aug 8, 2023
A big thanks to the 18 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.14.4@mui/system@5.14.4component from TypeMap (#38168)" (#38356) @michaldudak@mui/base@5.0.0-beta.10<!-- 32 -->[base] Ban default exports (#38200) @michaldudak
Base UI default exports were changed to named ones. Previously we had a mix of default and named ones. This was changed to improve consistency and avoid problems some bundlers have with default exports. See https://github.com/mui/material-ui/issues/21862 for more context.
- import Button, { buttonClasses } from '@mui/base/Button';
+ import { Button, buttonClasses } from '@mui/base/Button';
- import BaseMenu from '@mui/base/Menu';
+ import { Menu as BaseMenu } from '@mui/base/Menu';
Additionally, the ClassNameGenerator has been moved to the directory matching its name:
- import ClassNameGenerator from '@mui/base/className';
+ import { ClassNameGenerator } from '@mui/base/ClassNameGenerator';
A codemod is provided to help with the migration:
npx @mui/codemod v5.0.0/base-use-named-imports <path>
@mui/joy@5.0.0-beta.1MenuButton (#38342) @sai6855ResponsiveAppBar demo logo href (#38346) @iownthegameUnstyled prefix from demos' function names (#38270) @sai6855async keyword from test (#38373) @ZeeshanTamboliAll contributors of this release in alphabetical order: @alisasanib, @cherniavskii, @DanailH, @danilo-leal, @iownthegame, @michaldudak, @mj12albert, @mnajdova, @noraleonte, @oliviertassinari, @richbustos, @sai6855, @samuelsycamore, @siriwatknp, @VishruthR, @yash-thakur, @zanivan, @ZeeshanTamboli
A big thanks to the 17 contributors who made this release possible. Here are some highlights ✨:
Jul 31, 2023
A big thanks to the 17 contributors who made this release possible. Here are some highlights ✨:
material-next (#37850) @DiegoAndai@mui/material@5.14.3getOptionLabel prop in ownerState (#38100) @DSK9012component field to *Props types (#38084) @michaldudak@mui/base@5.0.0-beta.9@mui/joy@5.0.0-beta.0@mui/material-next@6.0.0-alpha.95@mui/system@5.14.3component from TypeMap (#38168) @michaldudakloading prop documentation (#38156) @sai6855Required utility type from Typography font style type (#38203) @ZeeshanTamboliAll contributors of this release in alphabetical order: @cherniavskii, @DiegoAndai, @divyammadhok, @DSK9012, @flaviendelangle, @gitstart, @michaldudak, @mj12albert, @mnajdova, @oliviertassinari, @prakhargupta1, @richbustos, @rluzists1, @sai6855, @siriwatknp, @zanivan, @ZeeshanTamboli
<!-- 30 -->[core] Remove the deprecation rule in tslint (#38087) @michaldudak
Jul 25, 2023
A big thanks to the 23 contributors who made this release possible.
component prop to OverrideProps type (#35924)" (#38150) @michaldudakJoy- prefix with Mui- (#38086) @siriwatknpAll contributors of this release in alphabetical order: @alexfauquette, @Bestwebdesign, @bharatkashyap, @danilo-leal, @DiegoAndai, @harikrishnanp, @IgnacioUtrilla, @mbrookes, @michaldudak, @mj12albert, @mnajdova, @nikohoffren, @oliviertassinari, @onderonur, @prakhargupta1, @richbustos, @sai6855, @SaidMarar, @samuelsycamore, @siriwatknp, @Studio384, @zanivan, @ZeeshanTamboli
<!-- 09 -->[Modal] Remove deprecated BackdropComponent and BackdropProps from tests (#38018) @sai6855
Jul 19, 2023
A big thanks to the 24 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.14.1labelPlacement is provided (#37831) @ZeeshanTamboliBackdropComponent and BackdropProps from tests (#38018) @sai6855@mui/material-next@6.0.0-alpha.93@mui/base@5.0.0-beta.8@mui/joy@5.0.0-alpha.88ToggleButton component (#37716) @siriwatknpSkeleton component (#37893) @siriwatknp@mui/utils@5.14.1useEventCallback (#37827) @cherniavskiicomponent prop to OverrideProps type (#35924) @sai6855@types/node to v18 (#37965) @ZeeshanTamboliAll contributors of this release in alphabetical order: @alexfauquette, @brijeshb42, @cherniavskii, @DanailH, @danilo-leal, @DiegoAndai, @divyammadhok, @ericbrian, @Janpot, @joserodolfofreitas, @Methuselah96, @michaldudak, @mj12albert, @mnajdova, @officialrajdeepsingh, @oliviertassinari, @OmPr366, @OndrejHj04, @prakhargupta1, @sai6855, @samuelsycamore, @siriwatknp, @zanivan, @ZeeshanTamboli
[docs-infra] Fix marked deprecation warning (#37769) @alexfauquette
Jul 11, 2023
A big thanks to the 15 contributors who made this release possible. Here are some highlights ✨:
💫 Material UI, Joy UI, and Base UI are compatible with NextJS App Router (#37656) @mj12albert
📚 Added new guides for integrating with Next.js 13 App Router (#37656) @mj12albert
🐛 bug fixes, 📚 documentation, and ⚙️ infrastructure improvements.
@mui/material@5.14.0@mui/material-next@6.0.0-alpha.92@mui/joy@5.0.0-alpha.87@mui/icons-material@5.14.0"use client" (#37894) @mj12albertvariant and color defaults for the playground (#37817) @Studio384undefined as an option to stripe (#37816) @Studio384marked deprecation warning (#37769) @alexfauquetteAll contributors of this release in alphabetical order: @alexfauquette, @cherniavskii, @danilo-leal, @DiegoAndai, @enrique-ramirez, @gitstart, @LukasTy, @MaybePixem, @mj12albert, @mnajdova, @nicolas-ot, @oliviertassinari, @samuelsycamore, @siriwatknp, @Studio384
A big thanks to the 21 contributors who made this release possible. This release focuses primarily on 🐛 bug fixes, 📚 documentation, and ⚙️ infrastruct
Jul 4, 2023
A big thanks to the 21 contributors who made this release possible. This release focuses primarily on 🐛 bug fixes, 📚 documentation, and ⚙️ infrastructure improvements.
@mui/material@5.13.7ownerState (#37668) @vonagam@mui/system@5.13.7<style> children (#34966) @cmd-johnson@mui/icons-material@5.13.7@mui/joy@5.0.0-alpha.86Menu usage demo (#37797) @sai6855@mui/base@5.0.0-beta.6disableSwap={true} (#35998) @sai6855@mui/lab@5.0.0-alpha.135alternate-reverse generated classname (#37678) @ZeeshanTamboliAll contributors of this release in alphabetical order: @AdamSundberg, @alexfauquette, @bigteech, @cherniavskii, @cmd-johnson, @DanailH, @danilo-leal, @Dlouxgit, @gateremark, @Janpot, @michaldudak, @mnajdova, @MUK-Dev, @oliviertassinari, @sai6855, @saikathalderr, @siriwatknp, @vonagam, @zanivan, @ZeeshanTamboli, @zephyrus21
A big thanks to the 12 contributors who made this release possible. Here are some highlights ✨:
A big thanks to the 12 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.13.4focusVisible class in AutocompleteClasses (#37502) @sai6855steps is one (#37079) @gitstart@mui/base@5.0.0-beta.4@mui/joy@5.0.0-alpha.83alt when src or srcSet are not defined (#37469) @vishalthatipamula0219component prop in docs (#37462) @sai6855examples packages updates (#37386) @ZeeshanTamboliAll contributors of this release in alphabetical order: @brijeshb42, @danielplewes, @danilo-leal, @DiegoAndai, @gitstart, @MBilalShafi, @mj12albert, @oliviertassinari, @sai6855, @siriwatknp, @vishalthatipamula0219, @ZeeshanTamboli
A big thanks to the 15 contributors who made this release possible. This release focuses primarily on 🐛 bug fixes and 📚 documentation improvements.
A big thanks to the 15 contributors who made this release possible. This release focuses primarily on 🐛 bug fixes and 📚 documentation improvements.
@mui/material@5.13.3className from BackdropProps (#37399) @hbjORbj@mui/base@5.0.0-beta.3@mui/joy@5.0.0-alpha.82slots element type in API docs (#37329) @zignis@mui/codemod@5.13.3All contributors of this release in alphabetical order: @akash191095, @brijeshb42, @canac, @DavidCnoops, @gitstart, @hbjORbj, @JhonnK08, @LukasTy, @michaldudak, @necatiozmen, @nicolas-ot, @oliviertassinari, @sai6855, @ZeeshanTamboli, @zignis
A big thanks to the 12 contributors who made this release possible. 📚 This release focuses primarily on documentation improvements.
A big thanks to the 12 contributors who made this release possible. 📚 This release focuses primarily on documentation improvements.
@mui/material@5.13.2@babel/plugin-proposal-class-properties from Material-Express-SSR example (#37305) @ZeeshanTamboliAll contributors of this release in alphabetical order: @alexfauquette, @brijeshb42, @cherniavskii, @danilo-leal, @m4theushw, @michaldudak, @mnajdova, @oliviertassinari, @PunitSoniME, @sai6855, @TinaSay, @ZeeshanTamboli
A big thanks to the 25 contributors who made this release possible. Here are some highlights ✨:
A big thanks to the 25 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.13.1@mui/utils@5.13.1@mui/base@5.0.0-beta.1@mui/joy@5.0.0-alpha.80filterOptions prop in Autocomplete's API docs (#37230) @ZeeshanTambolitest_static CI doc in CONTRIBUTING readme file (#36711) @kriskw1999alpha to beta in README (#37228) @ZeeshanTambolitoEqualDateTime chai matcher (#37073) @flaviendelangleAll contributors of this release in alphabetical order: @Bastian, @binh1298, @cccEric, @cherniavskii, @DerTimonius, @DiegoAndai, @flaviendelangle, @hbjORbj, @jguddas, @kkocdko, @kriskw1999, @mauwaz, @michaldudak, @mnajdova, @nickiaconis, @nicolas-ot, @oliviertassinari, @PunitSoniME, @richbustos, @safeamiiir, @sai6855, @siriwatknp, @uuxxx, @zanivan, @ZeeshanTamboli
🚀 Base UI is now in beta - all planned breaking changes are now complete!
A big thanks to the 18 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.13.0ChipComponent type (#37112) @sai6855@mui/joy@5.0.0-alpha.79@mui/base@5.0.0-beta.0optionStringifier prop (#37118) @michaldudakTextField customization using theme style overrides (#36805) @ZeeshanTambolie2e-website related minor fixes (#37204) @ZeeshanTamboliAll contributors of this release in alphabetical order: @akash191095, @DanailH, @danilo-leal, @DerTimonius, @gerdadesign, @hbjORbj, @kriskw1999, @michaldudak, @mnajdova, @oliviertassinari, @PunitSoniME, @romgrk, @sai6855, @ulrichstark, @uuxxx, @wewakekumar, @ZeeshanTamboli, @zignis
all planned breaking changes for Base UI are done. The first beta release should come next week 🎉
May 2, 2023
A big thanks to the 18 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.12.3component type (#37111) @sai6855text (#36967) @DavidBoyer11@mui/joy@5.0.0-alpha.78@mui/base@5.0.0-alpha.128The component prop is no longer supported because it can be replaced with the slots API. This is how the transformation will look like:
<Button
- component="span"
+ slots={{ root: "span" }}
/>
If using TypeScript, the custom component type should be added as a generic on the Button component.
-<Button
+<Button<typeof CustomComponent>
slots={{ root: CustomComponent }}
customProp="foo"
/>
There is codemod that you can run in your project to do the transformation:
npx @mui/codemod v5.0.0/base-remove-component-prop <path>
The full documentation about the codemod can be found here.
This is the list of PR related to this change:
component prop (#36677) @mnajdovacomponent prop (#37028) @hbjORbj<!-- 41 -->[base] Improve API consistency (#36970) @michaldudak
Brought consistency to Base UI components and hooks' parameters and return values:
<slot_name>Ref, which matches the get<slot_name>Props in the return value.React.RefCallback as using the more general React.Ref caused variance issues.React.Ref<Element>back to top (#37011) @PunitSoniMEuseFormControl return values from demos page (#37036) @ZeeshanTamboliSwitchUnstyled (#36720) @varunmulay22InputUnstyled (#36724) @varunmulay22SliderUnstyled (#36721) @varunmulay22Snackbar (#36719) @varunmulay22SelectUnstyled (#36718) @varunmulay22All contributors of this release in alphabetical order: @cherniavskii, @DavidBoyer11, @hbjORbj, @jakub-stastny, @joserodolfofreitas, @maxdestors, @michaldudak, @mj12albert, @mnajdova, @navedqb, @nicolas-ot, @oliviertassinari, @PunitSoniME, @sai6855, @samuelsycamore, @siriwatknp, @varunmulay22, @ZeeshanTamboli
⚠️ [BREAKING CHANGE] The Unstyled suffix has been removed from Base UI component names, including names of types and other related identifiers – a cod…
<!-- generated comparing v5.12.1..master -->
Apr 25, 2023
A big thanks to the 12 contributors who made this release possible. Here are some highlights ✨:
Unstyled suffix has been removed from Base UI component names, including names of types and other related identifiers – a codemod script is provided to assist with the change.@mui/material@5.12.2filled when value is set through inputProps (#36741) @sai6855onChange handler should be called only when value has changed (#36706) @gitstartSorting & Selecting tables (#36898) @oliviertassinari@mui/base@5.0.0-alpha.127<!-- 27 -->[base] Remove unstyled suffix from Base components + Codemod script (#36873) @hbjORbj
The Unstyled suffix has been removed from all Base UI component names, including names of types and other related identifiers.
You can use this codemod to help with the migration:
npx @mui/codemod v5.0.0/base-remove-unstyled-suffix <path>
component prop codemod script (#36952) @hbjORbjcomponent prop from components (#36831) @hbjORbj@mui/joy@5.0.0-alpha.77invertedColors to Menu and Alert (#36975) @siriwatknpmaster (#37016) @hbjORbjAll contributors of this release in alphabetical order: @alexfauquette, @cherniavskii, @danilo-leal, @gitstart, @hbjORbj, @michaldudak, @mj12albert, @mnajdova, @oliviertassinari, @PupoSDC, @sai6855, @siriwatknp, @TakhyunKim, @tomaskebrle
A big thanks to the 16 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
Apr 17, 2023
A big thanks to the 16 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
@mui/material@5.12.1required prop (#34207) @emlaiinputTypeSearch class for outlined and filled inputs (#36740) @sai6855@mui/system@5.12.1<!-- 06 -->[Grid2] Replace context with cloneElement (#36399) @siriwatknp
Grid2 now uses React.cloneElement instead of React context for passing the spacing and columns to the next container. The change is close to how CSS flexbox behaves.
css object (#36853) @siriwatknp@mui/base@5.0.0-alpha.126MenuUnstyledContext is replaced by MenuProvider. The value to pass to the provider is returned by the useMenu hook.onClose prop is replaced by onOpenChange. It has the open parameter and is called when a menu is opened or closedSelectUnstyledContext is replaced by SelectProvider. The value to pass to the provider is returned by the useSelect hook.SelectUnstyled's popup is permanently mounted.defaultOpen prop was added to the SelectUnstyled. The open/close state can now be controlled or uncontrolled, as a value.TabsContext is replaced by TabsProvider. The value to pass to the provider is returned by the useTabs hook.null to Tabs' value prop, instead of false. This is consistent with how Select works.value prop is still technically not mandatory on TabUnstyled and TabPanel, but when omitted, the contents of the selected tab panel will not be rendered during SSR.@mui/joy@5.0.0-alpha.76*-child to *-of-type (#36839) @keyvanmBadgeUnstyled (#36723) @varunmulay22Parameters section of the API docs (#36773) @ZeeshanTamboliModalUnstyled (#36580) @gitstartTabs (#36577) @gitstartPopper (#36578) @gitstartTablePagination (#36593) @gitstartcomponent, slots, slotProps must be visible in Prop table in API docs (#36666) @hbjORbjAll contributors of this release in alphabetical order: @emlai, @flaviendelangle, @gitstart, @hbjORbj, @jesrodri, @keyvanm, @michaldudak, @mj12albert, @navedqb, @oliviertassinari, @rkdrnf, @sai6855, @samuelsycamore, @siriwatknp, @varunmulay22, @ZeeshanTamboli
A big thanks to the 9 contributors who made this release possible. Here are some highlights ✨:
Apr 11, 2023
A big thanks to the 9 contributors who made this release possible. Here are some highlights ✨:
@mui/system@5.12.0@mui/base@5.0.0-alpha.125ownerState with ownerState from props (#36599) @hbjORbj@mui/joy@5.0.0-alpha.75slots/slotsProps for every component (components with only root slot too) (#36540) @hbjORbjreadOnly state class in the list (#36788) @ZeeshanTamboliSliderUnstyled slots key name (#36830) @sai6855All contributors of this release in alphabetical order: @alirezahekmati, @danilo-leal, @hbjORbj, @Lioness100, @mnajdova, @oliviertassinari, @sai6855, @siriwatknp, @ZeeshanTamboli
A big thanks to the 17 contributors who made this release possible. Here are some highlights ✨:
Apr 4, 2023
A big thanks to the 17 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.11.16ownerState to enable overriding styles with it in theme (#36422) @gitstart@mui/icons-material@5.11.16@mui/joy@5.0.0-alpha.74ModalOverflow component (#36262) @siriwatknpCheckbox custom color prop type warning (#36691) @amal-qbuseFormControlUnstyledContext hook (#36302) @HeVictorFormControl (#36579) @gitstartMenu (#36582) @gitstartButton demos (#36590) @sai6855All contributors of this release in alphabetical order: @alexfauquette, @amal-qb, @danilo-leal, @DevinCLane, @gitstart, @hbjORbj, @HeVictor, @LadyBluenotes, @michaldudak, @mj12albert, @mnajdova, @oliviertassinari, @RBerthier, @sai6855, @siriwatknp, @viclafouch, @yushanwebdev
A big thanks to the 10 contributors who made this release possible. We have one big highlight this week ✨:
Mar 28, 2023
A big thanks to the 10 contributors who made this release possible. We have one big highlight this week ✨:
@mui/material@5.11.15@mui/system@5.11.15useFlexGap prop (#36404) @siriwatknp@mui/base@5.0.0-alpha.122autoSelect prop description (#36280) @sai6855actions type in slotProps (#36458) @sai6855@mui/joy@5.0.0-alpha.73theme.applyDarkStyles for the rest of the docs" (#36602) @mnajdovaSnackbar coming soon page (#36604) @danilo-lealtheme.applyDarkStyles (#36606) @siriwatknpSorting & Selecting table demo (#33236) @IFaniryAll contributors of this release in alphabetical order: @alexfauquette, @danilo-leal, @hbjORbj, @IFaniry, @joserodolfofreitas, @mnajdova, @oliviertassinari, @sai6855, @siriwatknp, @varunmulay22
A big thanks to the 15 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
Mar 21, 2023
A big thanks to the 15 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
@mui/material@5.11.14BreadcrumbCollapsed through slots (#33812) @pratikkarad@mui/system@5.11.14@mui/base@5.0.0-alpha.121@mui/joy@5.0.0-alpha.72--List-decorator* vars (#36595) @siriwatknp@mui/lab@5.0.0-alpha.124theme.applyDarkStyles for the rest of the docs (#36161) @siriwatknpshouldSkipGeneratingVar usage (#36581) @siriwatknpAll contributors of this release in alphabetical order: @danilo-leal, @dav1app, @gabrielnafuzi, @hbjORbj, @HediMuhamad, @michalak111, @mikailaread, @mnajdova, @oliviertassinari, @pratikkarad, @RomanHotsiy, @sai6855, @siriwatknp, @varunmulay22, @zaverden
A big thanks to the 13 contributors who made this release possible. Here are some highlights ✨:
Mar 14, 2023
A big thanks to the 13 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.11.13shouldSkipGeneratingVar from Material UI (#36489) @siriwatknp@mui/base@5.0.0-alpha.121All contributors of this release in alphabetical order: @erikian, @hbjORbj, @HeVictor, @hrutik7, @joserodolfofreitas, @m4theushw, @michaldudak, @oliviertassinari, @oyar99, @rayrw, @sai6855, @siriwatknp, @skevprog
This breaking change only affects experimental APIs
Mar 6, 2023
A big thanks to the 17 contributors who made this release possible. Here are some highlights ✨:
extendTheme so that it can generate CSS variables with default values. This means that the CssVarsProvider is no longer required for Joy UI when using the default theme (#35739)@mui/material@5.11.12Mui-expanded class (#33312) @Osman-Sodefaid prop provided to the DialogTitle component (#36353) @Kundan28@mui/lab@5.0.0-alpha.122@mui/system@5.11.12<!-- 26 -->[core] Generate vars in extendTheme (#35739) @mnajdova
The shouldSkipGeneratingVar prop was moved from the createCssVarsProvider's option to the theme. If the default theme does not use extendTheme from Material UI or Joy UI, it needs to be wrapped inside unstable_createCssVarsTheme - a util exported from the MUI System. Below is an example of how the migration should look like:
import {
unstable_createCssVarsProvider as createCssVarsProvider,
+ unstable_createCssVarsTheme as createCssVarsTheme,
} from '@mui/system';
const { CssVarsProvider } = createCssVarsProvider({
- theme: {
+ theme: createCssVarsTheme({
colorSchemes: {
light: {
typography: {
htmlFontSize: '16px',
h1: {
fontSize: '1rem',
fontWeight: 500,
},
},
},
},
+ shouldSkipGeneratingVar: (keys) => keys[0] === 'typography' && keys[1] === 'h1',
- },
+ }),
defaultColorScheme: 'light',
- shouldSkipGeneratingVar: (keys) => keys[0] === 'typography' && keys[1] === 'h1',
});
Or you can define it directly in the theme prop:
<CssVarsProvider
+ theme={createCssVarsProvider({
+ // other theme keys
+ shouldSkipGeneratingVar: (keys) => keys[0] === 'typography' && keys[1] === 'h1'
+ })} />
This breaking change only affects experimental APIs
@mui/base@5.0.0-alpha.120<!-- 27 -->[Select][base] Add the multiselect functionality to SelectUnstyled (#36274) @michaldudak
The MultiSelectUnstyled was removed. The SelectUnstyled component with the multiple prop should be used instead. Additionally, the SelectUnstyledProps received a second generic parameter: Multiple extends boolean. If you deal with strictly single- or multi-select components, you can hard-code this parameter to false or true, respectively. Below is an example of how the migration should look like:
-import MultiSelectUnstyled from '@mui/base/MultiSelectUnstyled';
+import SelectUnstyled from '@mui/base/SelectUnstyled';
export default App() {
-return <MultiSelectUnstyled />
+return <SelectUnstyled multiple />
}
import type syntax (#36411) @ZeeshanTamboli@mui/joy@5.0.0-alpha.70<!-- 09 -->[Joy] Change CSS variables naming for components (#36282) @hbjORbj
Joy UI has new naming standards of the CSS variables for its components. Below is an example of how the migration should look like:
-<List sx={{ py: 'var(--List-divider-gap)' }}>
+<List sx={{ py: 'var(--ListDivider-gap)' }}>
-<Switch sx={{ '--Switch-track-width': '40px' }}>
+<Switch sx={{ '--Switch-trackWidth': '40px' }}>
CssVarsProvider is required (#36410) @mnajdovaDivider (#36374) @sai6855buildApiUtils usage issues (#36310) @LukasTycombobox role queries in Autocomplete tests (#36394) @ZeeshanTamboliAll contributors of this release in alphabetical order: @cherniavskii, @hbjORbj, @joserodolfofreitas, @Kuba429, @Kundan28, @LukasTy, @MBilalShafi, @michaldudak, @mnajdova, @NoFr1ends, @oliviertassinari, @Osman-Sodefa, @Paatus, @sai6855, @SaidMarar, @varunmulay22, @ZeeshanTamboli
A big thanks to the 15 contributors who made this release possible. Here are some highlights ✨:
Feb 28, 2023
A big thanks to the 15 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.11.11sx prop to ListboxProps type (#36243) @sai6855readOnly prop (#32822) @jrparishdata-focusvisible attribute (#36091) @ZeeshanTamboliuseSnackbar hook (#36272) @ZeeshanTamboli@mui/base@5.0.0-alpha.119<!-- 29 -->[base] Remove classes prop from the Base components that have it (#36157) @hbjORbj
These are the components affected by this change: ModalUnstyled, SliderUnstyled, TablePaginationUnstyled and TablePaginationActionsUnstyled.
You can replace the classes prop by providing the class name prop directly to the prop via slotProps. Below is an example of how the migration should look like:
<TablePaginationUnstyled
- classes={{ toolbar: 'toolbar-classname', menuItem: 'menuItem-classname' }}
+ slotProps={{ toolbar: { className: 'toolbar-classname' }, menuItem: { className: 'menuItem-classname'}}}
/>
<!-- 28 -->[base] Move hooks to their own directories (#36235) @hbjORbj
Base hooks (e.g., useSelect) are no longer exported from {Component}Unstyled directories and instead they have their own directories.
Below is an example of how the migration should look like:
-import { useBadge } from '@mui/base/BadgeUnstyled';
+import useBadge from '@mui/base/useBadge';
You can use this codemod to help with the migration.
@mui/codemod@5.11.11@mui/joy@5.0.0-alpha.69ListDivider to change semantic based on List (#36266) @siriwatknp:first-child (#36263) @siriwatknpmaterial-next-ts-v4-v5-migration example README (#36321) @ZeeshanTambolireadOnly state class (#36357) @ZeeshanTamboliAll contributors of this release in alphabetical order: @hbjORbj, @HeVictor, @ivp-dev, @jrparish, @Juneezee, @LukasTy, @MBilalShafi, @michaldudak, @mnajdova, @oliviertassinari, @ossan-engineer, @sai6855, @siriwatknp, @Vivek-Prajapatii, @ZeeshanTamboli
A big thanks to the 17 contributors who made this release possible. Here are some highlights ✨:
Feb 14, 2023
A big thanks to the 17 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.11.9@mui/styled-engine@5.11.9@mui/joy@5.0.0-alpha.67@mui/base@5.0.0-alpha.118slotProps per slot (#35964) @hbjORbjuseAutocomplete disabled prop not disabling the input (#36076) @sai6855@mui/material-next@6.0.0-alpha.75md as a CSS var prefix (#36177) @siriwatknpv6-alpha to v6-next in navigation (#36102) @LukasTytests/utils/index.js to TypeScript (#35382) @flaviendelangleAll contributors of this release in alphabetical order: @danilo-leal, @donaldnevermore, @flaviendelangle, @hbjORbj, @LadyBluenotes, @LukasTy, @m4theushw, @michaldudak, @mj12albert, @mnajdova, @oliv37, @oliviertassinari, @petyosi, @rangoo94, @sai6855, @Shorifpatwary, @siriwatknp
A big thanks to the 14 contributors who made this release possible. Here are some highlights ✨:
Feb 7, 2023
A big thanks to the 14 contributors who made this release possible. Here are some highlights ✨:
Sign In template to Joy UI (#36019)@mui/material@5.11.8FormLabelOwnProps from FormLabel to fix type error (#36057) @yoskeoka@mui/joy@5.0.0-alpha.66Table export from root (#36010) @sai6855@mui/system@5.11.8@mui/styled-engine@5.11.8document is available (#36001) @m4theushwcustomizing theme tokens (#36067) @badalsaiboAutocompleteProps type (#36039) @ArthurPedrotiAll contributors of this release in alphabetical order: @alexownejazayeri, @ArthurPedroti, @badalsaibo, @chuanyu0201, @joserodolfofreitas, @m4theushw, @michaldudak, @mj12albert, @mnajdova, @oliviertassinari, @sai6855, @siriwatknp, @yoskeoka, @ZeeshanTamboli
A big thanks to the 15 contributors who made this release possible. Here are some highlights ✨:
Jan 31, 2023
A big thanks to the 15 contributors who made this release possible. Here are some highlights ✨:
Table component to Joy UI (#35872)@mui/material@5.11.7unstable_sxConfig variables (#35932) @siriwatknpcomponent type (#35852) @sai6855@mui/base@5.0.0-alpha.116@mui/joy@5.0.0-alpha.65<!-- 05 -->[Joy] Replace Joy[Component] classname with Mui[Component] classname for all slots of components (#35718) @hbjORbj
'Joy' to 'Mui'. <Button
-sx={{ '& .JoyButton-root': { '& .JoyButton-button': {} } }}
+sx={{ '& .MuiButton-root': { '& .MuiButton-button': {} } }}
/>
You can use this codemod to help with the migration.
<!-- 04 -->[Joy] Replace row prop with orientation prop in all Joy UI components (#35721) @hbjORbj
row prop to orientation prop across Card, List and RadioGroup components in Joy UI. <Card
-row
+orientation={"horizontal"}
/>
You can use this codemod to help with the migration.
Table component (#35872) @siriwatknpdefaultMode changes (#35937) @ArthurPedrotiUsing icon libraries page (#35989) @badalsaiboConfigure the sx prop page in dark mode (#35961) @ZeeshanTambolifalse in API docs (#35913) @hbjORbjAll contributors of this release in alphabetical order: @ArthurPedroti, @badalsaibo, @gorjiali, @hbjORbj, @HeVictor, @idebeijer, @joserodolfofreitas, @marktoman, @oliviertassinari, @sai6855, @SaidMarar, @samuelsycamore, @siriwatknp, @Vivek-Prajapatii, @ZeeshanTamboli
A big thanks to the 13 contributors who made this release possible. Here are some highlights ✨:
Jan 23, 2023
A big thanks to the 13 contributors who made this release possible. Here are some highlights ✨:
SliderUnstyled (#35805)@mui/material@5.11.6@mui/base@5.0.0-alpha.115<!-- 04 -->[SliderUnstyled] Improved logic for displaying the value label (#35805) @ZeeshanTamboli
valueLabelDisplay prop is removed from SliderUnstyled. The prop was not working as intended in SliderUnstyled (See #35398). You can instead provide a valueLabel slot with the slots prop API to show the value label:- <SliderUnstyled valueLabelDisplay="on" />
+ <SliderUnstyled slots={{ valueLabel: SliderValueLabel }} />
The following demo shows how to show a value label when it is hovered over with the thumb: https://mui.com/base/react-slider/#value-label
sliderUnstyledClasses since they are not needed for the value label:- valueLabel
- valueLabelOpen
- valueLabelCircle
- valueLabelLabel
In the custom value label component, you can define your own classNames and target them with CSS.
The SliderValueLabelUnstyled component is removed from SliderUnstyled. You should provide your own custom component for the value label.
To avoid using React.cloneElement API in value label, the component hierarchy structure of the value label is changed. The value label is now inside the Thumb slot - Thumb -> Input, ValueLabel.
inputRef is ignored (#35807) @sai6855@mui/joy@5.0.0-alpha.64imgProps prop and add Codemod script for migration (#35859) @hbjORbjColor page (#35873) @oliv37docs-utilities migration to TypeScript and fix type (#35881) @ZeeshanTambolidocs-utilities package to TypeScript (#35846) @ZeeshanTamboliAll contributors of this release in alphabetical order: @HeVictor, @hbjORbj, @joserodolfofreitas, @mj12albert, @mnajdova, @oliv37, @oliviertassinari, @petyosi, @rosita-dmello, @sai6855, @SaidMarar, @tech-meppem, @ZeeshanTamboli
Your coding agent can read these notes before it upgrades. Set up the MCP server →