NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #2941 most downloaded on npm
Utility functions for React components.
Latest stable
9.5.0
Last release 1 months ago
12 Oct 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
175 releases · first in 2021
Drag across the ruler to compare, or tap a release to open it.
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
Your coding agent can read these notes before it upgrades. Set up the MCP server →
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
<!-- 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
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 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.6svg as a child (#37231) @siriwatknpslotProps (#37550) @SuperKXTclearTimeout() (#37512) @romgrk@mui/material-next@6.0.0-alpha.90@mui/joy@5.0.0-alpha.85CardActions component (#37441) @siriwatknpMenu in demos (#36917) @sai6855@mui/base@5.0.0-beta.5areOptionsEqual prop (#37615) @michaldudak@mui/utils@5.13.2test-dev CI (#37604) @ZeeshanTamboliA 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
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
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 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 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
<!-- 20 -->[docs] Fix ListItem button deprecated use (#33970) @MickaelAustoni
Dec 26, 2022
A big thanks to the 20 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.11.2faIR locale (#35587) @hootan-rockyscope prop to be not set when a data cell is rendered within a table head (#35559) @sai6855@mui/utils@5.11.2mergedeep deeply clones source key if it's an object (#35364) @sldk-yuri@mui/base@5.0.0-alpha.112isRtl from Material UI's Slider props (#35564) @michaldudak@mui/joy@5.0.0-alpha.60@mui/material-next@6.0.0-alpha.68sortStability() use case (#35570) @frontendlanelight theme mode when activePage is null (#35575) @LukasTyProgress docs (#35553) @jasonsturgesStack component (#35373) @hbjORbjGrid component (#35374) @hbjORbjAll contributors of this release in alphabetical order: @boutahlilsoufiane, @danhuynhdev, @danilo-leal, @EduardoSCosta, @ekusiadadus, @frontendlane, @hbjORbj, @hootan-rocky, @JagarYousef, @jasonsturges, @leventdeniz, @LukasTy, @michaldudak, @MickaelAustoni, @mnajdova, @oliviertassinari, @sai6855, @siriwatknp, @sldk-yuri, @trizotti
A big thanks to the 15 contributors who made this release possible. Here are some highlights ✨:
A big thanks to the 15 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.11.1size prop overrides via TypeScript module augmentation (#35460) @MickaelAustoniexperimental_sx back with error code (#35528) @siriwatknp@mui/utils@5.11.1@mui/material-next@6.0.0-alpha.67@mui/joy@5.0.0-alpha.59@mui/base@5.0.0-alpha.111Select component onChange event type in the migration guide (#35509) @tzynwangProviding the colors directly section (#35507) @cassidooCardMedia example without component="img" prop (#35470) @lucasmfredmarkunstable_sxConfig typo (#35478) @siriwatknpAll contributors of this release in alphabetical order: @42tte, @cassidoo, @danilo-leal, @DimaAbr, @lucasmfredmark, @michaldudak, @MickaelAustoni, @Miigaarino, @mnajdova, @oliviertassinari, @sai6855, @siriwatknp, @sydneyjodon-wk, @talgautb, @tzynwang
The breaking change is regarding an experimental API:
Dec 13, 2022
A big thanks to the 19 contributors who made this release possible. Here are some highlights ✨:
sx prop in the theme (#35150)@mui/material@5.11.0MenuProps.PopoverClasses being overriden (#35394) @vitorfrs-dev@mui/icons-material@5.11.0@mui/system@5.11.0[system] Enable configuring the sx prop in the theme (#35150) @mnajdova
The breaking change is regarding an experimental API:
-import { styled, experimental_sx } from '@mui/material/styles';
+import { styled } from '@mui/material/styles';
-const Component = styled('div)(experimental_sx({ p: 1 }});
+const Component = styled('div)(({ theme }) => theme.unstable_sx({ p: 1 }});
@mui/joy@5.0.0-alpha.58@mui/base@5.0.0-alpha.110@mui/material-next@6.0.0-alpha.66Responsive App bar with Drawer demo (#35418) @ZeeshanTamboliToggleButtonSizes demo (#35375) @Armanio/core page to use CSS variables (#35366) @siriwatknpAll contributors of this release in alphabetical order: @alexfauquette, @Armanio, @danilo-leal, @EduardoSCosta, @flaviendelangle, @jesrodri, @joserodolfofreitas, @kraftware, @michaldudak, @mnajdova, @oliviertassinari, @PratikDev, @samuelsycamore, @siriwatknp, @Spanishiwa, @timbset, @tsollbach, @vitorfrs-dev, @ZeeshanTamboli
A big thanks to the 13 contributors who made this release possible. This release contains various 🐛 bug fixes, 📚 documentation, and ⚙️ infrastructure
Nov 28, 2022
A big thanks to the 13 contributors who made this release possible. This release contains various 🐛 bug fixes, 📚 documentation, and ⚙️ infrastructure improvements.
@mui/material@5.10.16multiple prop is true (#35275) @fenghan34skipFocusWhenDisabled prop to not allow focussing deletable chip if disabled (#35065) @sai6855useFormControl (#35168) @ZeeshanTamboli@mui/system@5.10.16@mui/base@5.0.0-alpha.108describeConformance to TypeScript (#35193) @flaviendelangleAll contributors of this release in alphabetical order: @58bits, @alexfauquette, @fenghan34, @flaviendelangle, @iamxukai, @leventdeniz, @m4theushw, @michaldudak, @oliviertassinari, @sai6855, @siriwatknp, @ZeeshanTamboli, @Zetta56
A big thanks to the 9 contributors who made this release possible. Here are some highlights ✨:
A big thanks to the 9 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.10.15background.defaultChannel to CssVarsPalette (#35174) @alexfauquette@mui/icons-material@5.10.15@mui/material-next@6.0.0-alpha.63@mui/base@5.0.0-alpha.107error prop works in the Unstyled Input (#35171) @michaldudakAll contributors of this release in alphabetical order: @alexfauquette, @danilo-leal, @iamxukai, @Janpot, @MBilalShafi, @michaldudak, @oliviertassinari, @samuelsycamore, @siriwatknp
A big thanks to the 17 contributors who made this release possible. Here are some highlights ✨:
Nov 15, 2022
A big thanks to the 17 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.10.14palette.background.defaultChannel token (#35061) @siriwatknp@mui/system@5.10.14@mui/joy@5.0.0-alpha.54FormControl, LinearProgress and ListSubheader components from @mui/joy (#35003) @Studio384Autocomplete component (#34315) @siriwatknpMarkdownElement regression from adding CSS variables (#35096) @siriwatknpAll contributors of this release in alphabetical order: @alexfauquette, @bharatkashyap, @cherniavskii, @danilo-leal, @hbjORbj, @Janpot, @kennethbigler, @kushagra010, @michaldudak, @mnajdova, @ofir5300, @oliviertassinari, @sai6855, @sfavello, @sidtohan, @siriwatknp, @Studio384
A big thanks to the 7 contributors who made this release possible. Here are some highlights ✨:
A big thanks to the 7 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.10.9@mui/system@5.10.9<!-- 17 -->[system] Fix color-scheme implementation (#34639) @siriwatknp
The enableColorScheme prop has been removed from CssVarsProvider and getInitColorScheme (both Material UI and Joy UI).
Migration:
<CssBaseline enableColorScheme />.<CssBaseline />, see the docs.@mui/base@5.0.0-alpha.101@mui/joy@5.0.0-alpha.49All contributors of this release in alphabetical order: @HexM7, @joserodolfofreitas, @kushagra010, @michaldudak, @mnajdova, @oliviertassinari, @vanyaxk
BREAKING CHANGE: replace start/endIcon with start/endDecorator.
Sep 19, 2022
A big thanks to the 11 contributors who made this release possible. This release was mostly about 🐛 bug fixes and 📚 documentation improvements.
@mui/material@5.10.6Bootstrap even when label is not defined (#34343) @ZeeshanTamboli@mui/joy@5.0.0-alpha.46[button][joy] Replace start/endIcon prop with start/endDecorator (#34288) @hbjORbj
BREAKING CHANGE: replace start/endIcon with start/endDecorator.
// before
<Button startIcon={...} endIcon={...} />
// after
<Button startDecorator={...} endDecorator={...} />
Input and Textarea styles (#34281) @siriwatknp@mui/base@5.0.0-alpha.98[Select][base] Add event parameter to the onChange callback (#34158) @michaldudak
The SelectUnstyled and MultiSelectUnstyled onChange callbacks did not have event as the first parameter, leading to inconsistency with other components and native HTML elements.
This PR adds the event parameter as the first one and moves the newly selected value to the second position. Because of this, it's a breaking change.
This also affects Select from Joy UI.
// before
<SelectUnstyled onChange={(newValue) => { /* ... */ }} />
// after
<SelectUnstyled onChange={(event, newValue) => { /* ... */ }} />
typescript-to-proptypes, respect the value pass to the generic (#34311) @flaviendelangleAll contributors of this release in alphabetical order: @alexfauquette, @flaviendelangle, @hbjORbj, @Janpot, @michaldudak, @oliviertassinari, @renovate[bot], @samuelsycamore, @siriwatknp, @tomasz-sodzawiczny, @ZeeshanTamboli
A big thanks to the 16 contributors who made this release possible. Here are some highlights ✨:
Aug 29, 2022
A big thanks to the 16 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.10.3disableClearable is used (#34053) @mnajdova@mui/system@5.10.3@mui/base@5.0.0-alpha.95@mui/joy@5.0.0-alpha.43role proptypes (#34119) @siriwatknpcomponentsProps for all components (#34077) @siriwatknpcomponentsProps as a function (#34022) @siriwatknpTextarea component (#33975) @siriwatknpSelect component (#34091) @HexM7DatePicker component demo on the home page (#34054) @NaveenPantraOverridableComponent via module augmentation for better performance (#32735) @mnajdovaAll contributors of this release in alphabetical order: @alexfauquette, @bharatkashyap, @bicstone, @danilo-leal, @EthanStandel, @HexM7, @hoangph271, @JonathanAsbury-SPS, @michaldudak, @mnajdova, @NaveenPantra, @oliviertassinari, @pieetrus, @renovate[bot], @siriwatknp, @ZeeshanTamboli
A big thanks to the 15 contributors who made this release possible. Here are some highlights ✨:
Aug 1, 2022
A big thanks to the 15 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.9.3filled variant (#33587) @hbjORbjcolumnSpacing and rowSpacing props ignore higher breakpoints with 0 (#33480) @ZeeshanTamboli@mui/system@5.9.3@mui/codemod@5.9.3@mui/styled-engine-sc@5.9.3@mui/joy@5.0.0-alpha.38Sorting & selecting Table demo (#33674) @mracetteusePagination (#33675) @fullstackzachstyled API vs sx prop docs (#33665) @ZeeshanTambolitheme.vars is used in createTheme and mention this in the theming docs (#33619) @hbjORbjgetInitialProps with getStaticProps (#33684) @mnajdovaAll contributors of this release in alphabetical order: @cherniavskii, @danilo-leal, @fullstackzach, @garronej, @hbjORbj, @husseinsaad98, @joserodolfofreitas, @michaldudak, @mnajdova, @MonstraG, @mracette, @oliviertassinari, @samuelsycamore, @siriwatknp, @ZeeshanTamboli
<!-- 20 -->[core] Update CHANGELOG to include pickers breaking change (#33486) @siriwatknp
Jul 18, 2022
A big thanks to the 17 contributors who made this release possible. This release is mainly about 🐛 bug fixes and 📚 documentation improvements
@mui/material@5.9.1event.touches are an empty array (#32974) @lukeggchapman@mui/system@5.9.1createEmptyBreakpointObject method (#33482) @ZeeshanTamboli@mui/base@5.0.0-alpha.90@mui/lab@5.0.0-alpha.91useTheme documentation (#33508) @rickstaainsertionPoint (#32104) @ANTARES-KORAll contributors of this release in alphabetical order: @abhinav-22-tech, @ajhenry, @ANTARES-KOR, @anthonypz, @aravindpanicker, @GabrielaLokelani, @HexM7, @lolaignatova, @lukeggchapman, @michaldudak, @mzedel, @Nikhilthadani, @oliviertassinari, @paustria, @rickstaa, @siriwatknp, @ZeeshanTamboli
⚠️ [BREAKING CHANGE] Date pickers are removed from the lab, please follow the migration guide. (#33386) @flaviendelangle
Jul 12, 2022
A big thanks to the 19 contributors who made this release possible. Here are some highlights ✨:
Unstable_Grid2 (#33479) @siriwatknp@mui/material@5.9.0clsx wrapper for single className (#33398) @ZeeshanTamboliTheme (#33434) @siriwatknp@mui/system@5.9.0Grid implementation (#32746) @siriwatknp@mui/lab@5.0.0-alpha.90[lab] Remove the pickers (#33386) @flaviendelangle
The pickers are moved to MUI X, check out the migration guide.
rem/em values for spacing prop (#33384) @hbjORbj@mui/base@5.0.0-alpha.89@mui/joy@5.0.0-alpha.36All contributors of this release in alphabetical order: @baharalidurrani, @cherniavskii, @danilo-leal, @davidgarciab, @flaviendelangle, @hbjORbj, @ivan-ngchakming, @Janpot, @jgbae, @joebingham-wk, @joserodolfofreitas, @michaldudak, @mnajdova, @oliviertassinari, @omeraplak, @robyyo, @samuelsycamore, @siriwatknp, @ZeeshanTamboli
A big thanks to the 13 contributors who made this release possible. Here are some highlights ✨:
Jun 27, 2022
A big thanks to the 13 contributors who made this release possible. Here are some highlights ✨:
@mui/material@mui/material@5.8.6<!-- 27 -->[Alert] Add support for CSS vars (#32624) @haneenmahd
<!-- 26 -->[Alert] Use getContrastText for filled variant font color (#29813) @SamoraMabuya
Note: The color of the text in the warning contained Alert in dark mode was changed to black in order to improve the color contrast ratio
<!-- 11 -->[OutlinedInput] Fix ownerState undefined in theme style overrides (#33241) @siriwatknp
<!-- 08 -->[Tabs] Fix crash when used with React 18 & Suspense (#33277) @mnajdova
<!-- 05 -->[TypeScript] Add CSS vars type augmentation for Material UI (#33211) @siriwatknp
@mui/system@5.8.6@mui/utils@5.8.6@mui/base@5.0.0-alpha.87@mui/joy@5.0.0-alpha.34Sheet doc (#32820) @hbjORbjcomponentsProps.root taking precedence (#33097) @ZeeshanTamboliAll contributors of this release in alphabetical order: @davidgarciab, @Fafruch, @haneenmahd, @hbjORbj, @howlettt, @jacobweberbowery, @michaldudak, @mnajdova, @oliviertassinari, @SamoraMabuya, @siriwatknp, @WinmezzZ, @ZeeshanTamboli
<!-- 34 -->[core] Update dependencies to fix security vulnerabilities (#33095) @michaldudak
Jun 14, 2022
A big thanks to the 24 contributors who made this release possible. Here are some highlights ✨:
Grid component by @boutahlilsoufiane@mui/material@5.8.4ButtonClasses type (#33040) @ZeeshanTamboligetOffsetTop & getOffsetLeft from Popover's index and add typings (#32959) @rartRTL direction specific logic (#32808) @aaarichter@mui/system@5.8.4@mui/codemod@5.8.4@mui/styles/makeStyles imports (#32962) @joshkel@mui/lab@5.0.0-alpha.86forwardRef warning when importing from the index (#33134) @mnajdova@mui/base@5.0.0-alpha.85@mui/joy@5.0.0-alpha.32MUI Base docs (#33091) @ZeeshanTamboliInputUnstyled docs (#33077) @ZeeshanTamboliAll contributors of this release in alphabetical order: @aaarichter, @alansouzati, @boutahlilsoufiane, @cherniavskii, @danilo-leal, @dvlprAlamin, @frankkluijtmans, @igordanchenko, @Janpot, @joshkel, @Kai-W, @KeaghanKennedy, @l-zoy, @michaldudak, @mkrtchian, @mnajdova, @Moizsohail, @oliviertassinari, @pushys, @rart, @siriwatknp, @tech-meppem, @winderica, @ZeeshanTamboli
A big thanks to the 14 contributors who made this release possible. Here are some highlights ✨:
May 17, 2022
A big thanks to the 14 contributors who made this release possible. Here are some highlights ✨:
jss to tss-react migration is out thanks to @ryancogswell@mui/material@5.8.0getInputProps TypeScript return type (#32730) @ZeeshanTamboli@mui/system@5.8.0Container component and createContainer factory (#32263) @mnajdova@mui/base@5.0.0-alpha.81@mui/joy@5.0.0-alpha.28@mui/codemod@5.8.0MuiPage interface to separate file (#32715) @cherniavskiispacing parameter from createMixins method (#32690) @ZeeshanTamboliAll contributors of this release in alphabetical order: @andrii-bodnar, @cherniavskii, @danilo-leal, @emlai, @joserodolfofreitas, @michaldudak, @mnajdova, @MrHBS, @oliviertassinari, @ryancogswell, @samuelsycamore, @shadigaafar, @siriwatknp, @ZeeshanTamboli
[core] Update minimist to fix security vulnerability (#32575) @michaldudak
May 10, 2022
A big thanks to the 27 contributors who made this release possible. Here are some highlights ✨:
🛠 This release is all about supporting CSS variables in many Material UI components. Kudos to all contributors!
@mui/material@5.7.0endAdornment only when necessary (#32386) @g1eny0ung@mui/system@5.7.0@mui/base@5.0.0-alpha.80@mui/private-classnames@5.7.0ListItemButton in ListItem in the Drawer examples (#31987) @stefanprobstimport '<library name>' in demonstrations (#32492) @alexfauquettedocs:dev not working after upgrading next to 12.1.0 (#32552) @cherniavskiiAll contributors of this release in alphabetical order: @alexfauquette, @alisasanib, @ameetmadan, @Ariyapong, @cherniavskii, @dan-mba, @danilo-leal, @elliefoote, @flaviendelangle, @g1eny0ung, @gin1314, @haneenmahd, @ivan-ngchakming, @Jamaalwbrown, @jcvidiri, @michaldudak, @mikepricedev, @mnajdova, @nghiamvt, @oliviertassinari, @pzi, @samuelsycamore, @siriwatknp, @stefanprobst, @vicasas, @vladjerca, @ZeeshanTamboli
A big thanks to the 8 contributors who made this release possible. This release is mostly about 🐛 bug fixes and 📚 documentation improvements.
Apr 11, 2022
A big thanks to the 8 contributors who made this release possible.
This release is mostly about 🐛 bug fixes and 📚 documentation improvements.
@mui/material@5.6.1@mui/base@5.0.0-alpha.76ahrefs report (#32206) @siriwatknpAll contributors of this release in alphabetical order: @danilo-leal, @DouglasPds, @igordanchenko, @l10nbot, @michaldudak, @oliviertassinari, @samuelsycamore, @siriwatknp
A big thanks to the 15 contributors who made this release possible. Here are some highlights ✨:
A big thanks to the 15 contributors who made this release possible. Here are some highlights ✨:
CssVarsProvider in @mui/material for generating theme CSS variables (#31138) @mnajdova@mui/material@5.6.0sx color to support callback (#32123) @siriwatknp@mui/base@5.0.0-alpha.75@mui/codemod@5.6.0@mui/lab@5.0.0-alpha.76@mui/joy@5.0.0-alpha.22Card components (#32027) @siriwatknpAll contributors of this release in alphabetical order: @apeltop, @eps1lon, @flaviendelangle, @garronej, @ivan-ngchakming, @m4theushw, @MatthijsMud, @michaldudak, @mnajdova, @oliviertassinari, @psjishnu, @raigoinabox, @samuelsycamore, @siriwatknp, @TkaczykAdam
<!-- 28 -->[core] Replace deprecated String.prototype.substr() (#31806) @CommanderRoot
Mar 28, 2022
A big thanks to the 17 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.5.3@mui/codemod@5.5.3@mui/utils@5.5.3@mui/base@5.0.0-alpha.74<!-- 34 -->[base] Remove BackdropUnstyled component (#31923) @mnajdova
The BackdropUnstyled component was removed from the @mui/base package, as it did not have any specific logic, except adding an aria-hidden attribute on the div it rendered. This is not enough to justify it's existence in the base package. Here is an example alternative component you can use:
const BackdropUnstyled = React.forwardRef<HTMLDivElement, { open?: boolean; className: string }>(
(props, ref) => {
const { open, className, ...other } = props;
return <div className={clsx({ 'MuiBackdrop-open': open }, className)} ref={ref} {...other} />;
},
);
<!-- 03 -->[TrapFocus] Move docs to Base and drop the Unstyled prefix (#31954) @michaldudak
Removed the Unstyled_ prefix from the Base export (it remains in the Material UI export, though).
-import { Unstyled_TrapFocus } from '@mui/base';
+import { TrapFocus } from '@mui/base';
// or
-import TrapFocus from '@mui/base/Unstyled_TrapFocus';
+import TrapFocus from '@mui/base/TrapFocus';
@mui/joy@5.0.0-alpha.21AvatarGroup component (#31980) @siriwatknpSplitButton demo (#31969) @mnajdovastyled() utility page (#31967) @jason1985LiveReload (#31269) @eswarclynnStandardProps and polymorphic components (#31945) @mnajdovaAll contributors of this release in alphabetical order: @bicstone, @CommanderRoot, @dimitropoulos, @eps1lon, @eswarclynn, @igordanchenko, @jannes-io, @jason1985, @m4theushw, @michaldudak, @mnajdova, @NickFoden, @oliviertassinari, @ryancogswell, @santhoshbala0178, @siriwatknp, @WilsonNet
<!-- 04 -->[Typescript] Remove variants deprecation (#31239) @siriwatknp
Feb 28, 2022
A big thanks to the 17 contributors who made this release possible. Here are some highlights ✨:
Input and Sheet components were added in the experimental Joy design system by @hbjORbj (#31124, #31086) @hbjORbj@mui/material@5.4.4@mui/system@5.4.4CssVarsProvider theme mutation (#31148) @siriwatknp@mui/codemod@5.4.4@mui/base@5.0.0-alpha.70@mui/joy@5.0.0-alpha.17Switch (#31137) @siriwatknpSheet component (#31124) @hbjORbjInput component (#31086) @siriwatknpmaterial-ui for product name (#31200) @siriwatknpFormControl API documentation (#31169) @bonelliaAll contributors of this release in alphabetical order: @adriancampos, @Andarist, @bonellia, @davwheat, @greengiraffe, @hbjORbj, @iclaude3, @m4theushw, @michaldudak, @mnajdova, @oliviertassinari, @PunitSoniME, @RedHeadphone, @robertwt7, @samuelsycamore, @siriwatknp, @sviande
A big thanks to the 16 contributors who made this release possible. Here are some highlights ✨:
Feb 15, 2022
A big thanks to the 16 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.4.2onClick and onChange (#30883) @sydneyjodon-wk@mui/system@5.4.2@mui/lab@5.0.0-alpha.69@mui/joy@5.0.0-alpha.15sx prop work in Joy (#30955) @siriwatknpshouldForwardProp option (#30978) @mnajdovaAll contributors of this release in alphabetical order: @agauravdev, @alisasanib, @DanailH, @danilo-leal, @huyenltnguyen, @l10nbot, @liradb2000, @mbrookes, @michaldudak, @mnajdova, @newguy-123, @oliviertassinari, @ryohey, @samuelsycamore, @siriwatknp, @sydneyjodon-wk
A big thanks to the 24 contributors who made this release possible. Here are some highlights ✨:
Feb 8, 2022
A big thanks to the 24 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.4.1@mui/base@5.0.0-alpha.68@mui/lab@5.0.0-alpha.68onDismiss handler in MobileDatePicker (#30768) @Ashish2097@mui/joy@5.0.0-alpha.14IconButton component (#30864) @siriwatknpTrapFocus (#30912) @flaviendelangleAll contributors of this release in alphabetical order: @alisasanib, @altruity, @Ashish2097, @caioagiani, @CFarhad, @cherniavskii, @danilo-leal, @eps1lon, @flaviendelangle, @garronej, @GneyHabub, @joeframbach, @johsunds, @kjschabra, @m4theushw, @michaldudak, @mihailgaberov, @mnajdova, @mogrady88, @oliviertassinari, @paales, @pppp606, @siriwatknp, @theiliad
A big thanks to the 15 contributors who made this release possible. Here are some highlights ✨:
Jan 17, 2022
A big thanks to the 15 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.3.0Paper component (#30515) @ZeeshanTamboli@mui/system@5.3.0textTransform prop should work directly on component (#30437) @hbjORbjstyleOverrides slot (#30524) @siriwatknp@mui/lab@5.0.0-alpha.65@mui/codemod@5.3.0jscodeshift to remove colors dependency (#30578) @siriwatknp@mui/styled-engine-sc@5.3.0@mui/joy@5.0.0-alpha.11SvgIcon component (#30570) @hbjORbj@mui/base@5.0.0-alpha.65</p> from header of README.md (#30530) @yaboidocs:api script for Windows OS (#30533) @ZeeshanTamboliAll contributors of this release in alphabetical order: @alexfauquette, @alisasanib, @Atralbus, @cherniavskii, @danilo-leal, @eps1lon, @garronej, @glaucoheitor, @hbjORbj, @kkirsche, @mnajdova, @oliviertassinari, @siriwatknp, @VicHofs, @yaboi, @ZeeshanTamboli
A big thanks to the 25 contributors who made this release possible. Here are some highlights ✨:
Dec 6, 2021
A big thanks to the 25 contributors who made this release possible. Here are some highlights ✨:
✨ We have introduced a new unstyled component in @mui/base: TablePagination (#29759) @mnajdova
<a href="https://mui.com/components/tables/#unstyled-table"><img width="600" alt="unstyled table" src="https://user-images.githubusercontent.com/4512430/144862194-584356ef-7d9d-462c-a631-186a7e716193.png"></a>
You can follow our progress with unstyled components at https://github.com/mui-org/material-ui/issues/27170.
🎉 We have added an example of how to use MUI with Remix (#29952) @mnajdova
And many more 🐛 bug fixes and 📚 improvements.
@mui/material@5.2.3square prop (#29972) @daniel-sachssquare Paper prop (#30027) @ZeeshanTambolispacing prop when the value is object (#29880) @jayeclarkmultiple enabled (#29957) @Domino987@mui/system@5.2.3createBox (#29989) @mnajdovasx prop when used as array (#29911) @tasugi@mui/utils@5.2.3@mui-material/styles/cssUtils (#29621) @Semigradsky@mui/icons-material@5.2.1@mui/base@5.0.0-alpha.59@mui/lab@5.0.0-alpha.59DateRangePickerDayProps interface (#29067) @jonathanrtuckMonthPicker component's DOM element (#30021) @ZeeshanTamboli@mui/joy@5.0.0-alpha.5@mui/styled-engine-sc does not work in SSR (#30026) @mnajdovaAll contributors of this release in alphabetical order: @chao813, @daniel-sachs, @danilo-leal, @Domino987, @eduardomcv, @flaviendelangle, @fourjr, @genzyy, @hbjORbj, @huydhoang, @jayeclark, @jonathanrtuck, @kkorach, @l10nbot, @mbrookes, @MichaelDeBoey, @michaldudak, @mnajdova, @oliviertassinari, @ronwarner, @Semigradsky, @siriwatknp, @tasugi, @ThewBear, @ZeeshanTamboli
A big thanks to the 9 contributors who made this release possible. Here are some highlights ✨:
Nov 29, 2021
A big thanks to the 9 contributors who made this release possible. Here are some highlights ✨:
Snackbar and TextField in @mui/material (#29782) (#29850) (#29852) @eps1lon.sx syntax inside styled() utility (#29833) @mnajdova.createCssVarsProvider in @mui/system (#29845) (#29857) @hbjORbj.@mui/material@5.2.2@mui/joy@5.0.0-alpha.4Button - 1st iteration (#29464) @siriwatknp@mui/codemod@5.2.1@mui/system@5.2.2html[style] when unmounting (#29946) @eps1londisableTransitionOnChange in createCssVarsProvider (#29857) @hbjORbjenableColorScheme in createCssVarsProvider (#29845) @hbjORbj@mui/utils@5.2.2sx prop (#29905) @siriwatknpAll contributors of this release in alphabetical order: @danilo-leal, @eps1lon, @Harshikerfuffle, @hbjORbj, @mbrookes, @oliviertassinari, @radlinskii, @sinclairity, @siriwatknp
<!-- generated comparing v5.2.0..master -->
<!-- generated comparing v5.2.0..master -->
Nov 25, 2021
A big thanks to the 7 contributors who made this release possible. Here are some highlights ✨:
This is an early release to fix export 'useId' (imported as 'React') was not found in 'react' when bundling code depending on MUI Core.
experimental_sx utility (#29833) @mnajdovaAll contributors of this release in alphabetical order: @eps1lon, @karakib2k18, @kegi, @mbrookes, @mnajdova, @newguy-123, @oliviertassinari
[CHANGELOG] Explain why we do breaking changes @oliviertassinari
Nov 23, 2021
A big thanks to the 18 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.2.0disableRipple is set (#29298) @adamfitzgibbonvariants.style to accept callbacks (#29610) @mnajdova@mui/codemod@5.2.0jss-to-styled to support multiple withStyles (#29824) @siriwatknp@mui/icons-material@5.2.0@mui/system@5.2.0sx prop runtime issue when used as function (#29830) @mnajdovasx throw error when value is null or undefined (#29756) @siriwatknp@mui/styled-engine@5.2.0@mui/base@5.0.0-alpha.56focused is always false unless explicitly set to true @mwilkins91@mui/lab@5.0.0-alpha.56luxon version range (#29761) @eps1lon@mui/core is an alias for @mui/base (#29762) @eps1lonnext branch (#29748) @eps1loncreateRenderer (#29684) @eps1lonAll contributors of this release in alphabetical order: @abhinav-22-tech, @adamfitzgibbon, @bharatkashyap, @chao813, @DanailH, @danilo-leal, @eps1lon, @gnowland, @Janpot, @longzheng, @michaldudak, @mmacu, @mnajdova, @mwilkins91, @NatiG100, @oliviertassinari, @scallaway, @siriwatknp
<!-- generated comparing v5.1.0..master -->
<!-- generated comparing v5.1.0..master -->
Nov 16, 2021
A big thanks to the 15 contributors who made this release possible. Here are some highlights ✨:
@mui/core to @mui/base (#29585) @michaldudak.@mui/material@5.1.1multiple class (#29566) @aaronhollaSelect is not a root component (#29593) @hbjORbj@mui/base@5.0.0-alpha.55<!-- 27 -->[core] Rename mui/core to mui/base (#29585) @michaldudak
Based on the results of the poll and our internal discussions, we decided to rename the @mui/core package to @mui/base. The main rationale for this is the fact that we use the term "Core" to refer to the core components product family, the one that includes Material Design components, unstyled components, System utilities, etc. Therefore, @mui/core was effectively a subset of MUI Core. This was confusing.
The new name better reflects the purpose of the package: it contains unstyled components, hooks, and utilities that serve as a base to build on.
-import { useSwitch } from '@mui/core/SwitchUnstyled';
+import { useSwitch } from '@mui/base/SwitchUnstyled';
@mui/lab@5.0.0-alpha.55ThemeProvider API link (#29573) @siriwatknpexperiments index page (#29582) @siriwatknpgetJsxPreview util (#29586) @ZeeshanTamboliraf helper is for (#29683) @eps1loncreateServerRender with createRenderer (#29503) @eps1lonAll contributors of this release in alphabetical order: @aaronholla, @alexfauquette, @anikcreative, @daniel-sachs, @eps1lon, @flipvrijn, @hbjORbj, @joshua-lawrence, @michaldudak, @mnajdova, @netizer, @oliviertassinari, @petermikitsh, @siriwatknp, @ZeeshanTamboli
A big thanks to the 33 contributors who made this release possible. Here are some highlights ✨:
Nov 8, 2021
A big thanks to the 33 contributors who made this release possible. Here are some highlights ✨:
ButtonGroup (#28645) @ZeeshanTambolisx prop (#29297) @siriwatknp@mui/material@5.1.0hiddenLabel prop of TextField variant={filled} inside Autocomplete (#29234) @jatinsandilyaenableColorScheme prop so enable using color-scheme property to deal with dark mode (#29454) @alexfauquetteopen prop in componentsProps.popper can be optional (#29370) @ZeeshanTamboliclassName not getting applied from PopperProps (#29023) @ZeeshanTamboli@mui/system@5.1.0mode to CssVarsProvider (#29418) @siriwatknpsx prop (#29297) @siriwatknp@mui/codemod@5.1.0@mui/lab@5.0.0-alpha.54children (#29351) @hbjORbj@mui/joy@5.0.0-alpha.0private to leverage CodeSandbox (#29280) @siriwatknpprocess.browser (#29438) @oliviertassinariMuiTextField's default props in the migration guide (#29174) @tm1000Print export feature info on the pricing page (#29484) @DanailHdocs:api (#28828) @m4theushwcreateClientRender with new createRenderer API (#29471) @eps1lonAbortController on global (#29360) @eps1lonname in Rating (#29329) @eps1lonAll contributors of this release in alphabetical order: @adamfitzgibbon, @ainatenhi, @alexfauquette, @busches, @ChrisClaude, @dan-mba, @DanailH, @danilo-leal, @DASPRiD, @ElonVolo, @eps1lon, @eric-burel, @flaviendelangle, @gssakash, @hbjORbj, @IPJT, @jacklaurencegaray, @Jareechang, @jatinsandilya, @m4theushw, @mbeltramin, @mbrookes, @michaldudak, @mnajdova, @nicbarajas, @oliviertassinari, @Pablion, @robcaldecott, @siriwatknp, @tanay123456789, @tm1000, @Wimukti, @ZeeshanTamboli
<!-- generated comparing v5.0.0..master -->
<!-- generated comparing v5.0.0..master -->
Sep 22, 2021
A big thanks to the 15 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.0.1@mui/codemod@5.0.1@mui/lab@5.0.0-alpha.48seconds view (#25095) @breitembach<Alert icon={false} /> behaves (#28348) @nguyenkhanhnamscreen (#28507) @eps1lonAll contributors of this release in alphabetical order: @breitembach, @chetrit, @coder-freestyle, @danilo-leal, @danwoods, @eps1lon, @hbjORbj, @michaldudak, @mnajdova, @nguyenkhanhnam, @oliviertassinari, @sakura90, @siriwatknp, @valse, @xenostar
<!-- generated comparing v5.0.0-rc.1..next -->
<!-- generated comparing v5.0.0-rc.1..next -->
Sep 16, 2021
After over 400 days of development and over 40 canary releases, we are excited to introduce MUI Core v5.0.0!
Some statistics with the release of v5.0.0 compared to the one of v4.0.0:
A big thanks to the 600+ contributors who made the release possible!
The 5.0.0 version includes all changes done in the alpha, beta, and rc releases listed below. These are the changes done from the last release candidate version (5.0.0-rc.1):
@mui/material@5.0.0@mui/system@5.0.0@mui/codemod@5.0.0@mui/lab@5.0.0-alpha.46All contributors of this release in alphabetical order: @aghArdeshir, @Aurelain, @eps1lon, @goncalovf, @jedwards1211, @m4theushw, @mbrookes, @michaldudak, @mnajdova, @nikitabobers, @praveenkumar-kalidass, @siriwatknp, @sydneyjodon-wk, @tamboliasir1, @tholman, @zadeviggers, @ZeeshanTamboli
A big thanks to the 13 contributors who made this release possible. Here are some highlights ✨:
Sep 8, 2021
A big thanks to the 13 contributors who made this release possible. Here are some highlights ✨:
@mui/material@5.0.0-rc.1ref type from component (#28101) @eps1lonref of Select and input element (#28054) @DouglasPdsvalue (#28172) @eps1lon@mui/system@5.0.0-rc.1@mui/codemod@5.0.0-rc.1preset-safe (#28183) @mnajdova@mui/lab@5.0.0-alpha.46All contributors of this release in alphabetical order: @akashshyamdev, @aleccaputo, @DouglasPds, @eps1lon, @goncalovf, @hbjORbj, @michaldudak, @mnajdova, @oliviertassinari, @outofgamut, @paullaros, @RomarQ, @siriwatknp
A big thanks to the 18 contributors who made this release possible. Here are some highlights ✨:
Sep 1, 2021
A big thanks to the 18 contributors who made this release possible. Here are some highlights ✨:
🎉 Renamed packages to @mui/* as part of rebranding the company, following the strategy of expanding the library scope beyond Material Design. For more details about it, check the GitHub discussion.
🛠 Added mui-replace codemod for migrating @material-ui/* to new packages @mui/*. Check out this codemod detail or head to migration guide
🧪 Added new <Mansory> component to the lab, check it out. It has been crafted by our first intern, @hbjORbj 👏!
<img width="538" alt="" src="https://user-images.githubusercontent.com/3165635/131869894-32011cad-0420-4063-926a-339458eb4b85.png">
@mui/material@5.0.0-rc.0<!-- 33 -->[core] Rename packages (#28049) @mnajdova
replace @material-ui/* prefix with @mui/*:
@material-ui/system -> @mui/system
@material-ui/styles -> @mui/styles
@material-ui/lab -> @mui/lab
@material-ui/types -> @mui/types
@material-ui/styled-engine -> @mui/styled-engine
@material-ui/styled-engine-sc ->@mui/styled-engine-sc
@material-ui/private-theming -> @mui/private-theming
@material-ui/codemod -> @mui/codemod
except these 3 packages that are renamed.
@material-ui/core => @mui/material // represents Material Design components.
@material-ui/icons => @mui/icons-material // represents Material Design icons.
@material-ui/unstyled => @mui/core // fully functional components and hooks with no/minimum styles.
Note:
@mui/core(previously@material-ui/unstyled) is not the same as@material-ui/core.
We encourage you to use the codemod for smooth migration.
value prop (#27977) @vedadeeptaimage role if image prop is specified but no image component is specified (#27676) @eps1lon@mui/core@5.0.0-alpha.45@mui/lab@5.0.0-rc.0@mui/codemod@5.0.0-rc.0mui-replace codemod transform (#28060) @siriwatknpno-use-before-define (#27984) @eps1lonrelease:changelog script (#27941) @eps1lonAll contributors of this release in alphabetical order: @aaronlademann-wf, @bene-we, @chetas411, @eps1lon, @flaviendelangle, @hbjORbj, @iamhosseindhv, @m4theushw, @michaldudak, @mnajdova, @oliviertassinari, @rajzik, @rsxdalv, @siriwatknp, @StefanBRas, @StefanTobler, @tdmiller1, @vedadeepta
One column per quarter.