Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[blog] Add post about v5 Migration guide update #33063

Merged
merged 17 commits into from
Jun 20, 2022
Merged
Show file tree
Hide file tree
Changes from 15 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions docs/pages/blog/migration-update.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
import * as React from 'react';
import TopLayoutBlog from 'docs/src/modules/components/TopLayoutBlog';
import { docs } from './migration-update.md?@mui/markdown';

export default function Page() {
return <TopLayoutBlog docs={docs} />;
}
90 changes: 90 additions & 0 deletions docs/pages/blog/migration-update.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,90 @@
---
title: Why you should migrate to Material UI v5 today
description: We have completely revamped our Migration guide to reduce friction when upgrading to v5. Get started now!
date: 2022-06-15T00:00:00.000Z
authors: ['samuelsycamore']
card: true
tags: ['News', 'MUI Core']
samuelsycamore marked this conversation as resolved.
Show resolved Hide resolved
---

Are you still using Material UI v4 in 2022?

What are you thinking?! 😛 The [community is migrating](https://npm-stat.com/charts.html?package=@mui/material,@material-ui/core), don't stay behind.

We [released v5 in late 2021](/blog/mui-core-v5/), and since then, we've seen a steady migration of users over to the new packages.
This is exciting for us, because we're super proud of all the improvements that were shipped with v5.

But it seems as though a fair share of users are still hesitant to make the jump.
This could be because v5 contains many breaking changes from v4, so the migration can be a large undertaking.

That's why we've completely revamped our [v4 -> v5 migration guide](https://mui.com/material-ui/migration/migration-v4/)—to help reduce the amount of friction you might encounter when updating to v5.

We hope it helps!
Be sure to check out [the updated migration guide](https://mui.com/material-ui/migration/migration-v4/) in the Material UI docs.

## Why you should upgrade to v5
samuelsycamore marked this conversation as resolved.
Show resolved Hide resolved

Here are the top 5 reasons why you should upgrade to v5 ASAP.

### 1. React 18 support

Material UI v5 is the only version that fully supports [React 18](https://reactjs.org/blog/2022/03/29/react-v18.html), so you'll need to update if you want to take advantage of the latest and greatest React features.

### 2. New style engine
samuelsycamore marked this conversation as resolved.
Show resolved Hide resolved
samuelsycamore marked this conversation as resolved.
Show resolved Hide resolved

One of the biggest changes in v5 is the replacement of JSS with [Emotion](https://emotion.sh/docs/introduction) as the default style engine.
This offers significant advancements in performance when it comes to dynamic styles, and we also believe that it leads to a much more enjoyable developer experience.

Emotion unlocks many new customization options that developers had been requesting for years, such as custom style utility props, color variants, and custom theme variants.
Check out [this RFC on GitHub](https://github.com/mui/material-ui/issues/22342) for details about this change.

![Screenshot of the new style engine GitHub issue in Material UI's repository](/static/blog/migration-update/style-engine.png)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have tried to click on this image 😁


### 3. Better customization tools

Material UI v5 introduces the `sx` prop, which opens up a whole new realm of possibility for applying custom styles.
Now you can apply style rules to individual components without needing to involve the `styled()` API, which would be overkill when dealing with one-off styles.

The `sx` prop lets you work with a superset of CSS, making it very intuitive to pick up and start using if you're already comfortable with CSS.

```tsx
import * as React from 'react';
import Box from '@mui/material/Box';

export default function BoxSx() {
return (
<Box
sx={{
width: 300,
height: 300,
backgroundColor: 'primary.dark',
'&:hover': {
backgroundColor: 'primary.main',
opacity: [0.9, 0.8, 0.7],
},
}}
/>
);
}
```

### 4. IntelliSense prop descriptions

All prop descriptions are now written in TypeScript, which means that you can access details about the usage of a given prop right inside of your IDE—no need to seek out the official documentation to find this information.

![Screenshot of IntelliSense tooltip showing the details about the Material UI Badge component](/static/blog/migration-update/intellisense-tooltip.png)

samuelsycamore marked this conversation as resolved.
Show resolved Hide resolved
### 5. Upcoming CSS variables support

[CSS variables](https://developer.mozilla.org/en-US/docs/Web/CSS/Using_CSS_custom_properties) will help us solve a lot of customization issues in the future.
One of them is the dark mode flashing issue that has been requested for a long time.

More importantly, this feature is opt-in if you are using Material UI v5!
You can check out the progress on this effort [with the issue #32049](https://github.com/mui/material-ui/issues/32049).

## Upgrade now

What are you waiting for?
Jump into the [newly revised migration documention](https://mui.com/material-ui/migration/migration-v4/) and get started today.

Let us know if you have any questions along the way!
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.