-
-
Notifications
You must be signed in to change notification settings - Fork 32.3k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
[blog] Add blog post about support for Next.js App Router (#37929)
Signed-off-by: Sam Sycamore <[email protected]> Co-authored-by: Danilo Leal <[email protected]> Co-authored-by: Marija Najdova <[email protected]> Co-authored-by: Albert Yu <[email protected]>
- Loading branch information
1 parent
e7b5573
commit a5779da
Showing
5 changed files
with
54 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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 './mui-next-js-app-router.md?@mui/markdown'; | ||
|
||
export default function Page() { | ||
return <TopLayoutBlog docs={docs} />; | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,47 @@ | ||
--- | ||
title: MUI Core libraries support the Next.js App Router | ||
description: Material UI, Base UI, and Joy UI are now compatible with the App Router as Client Components. Get started using the latest Next.js features with MUI! | ||
date: 2023-07-18T00:00:00.000Z | ||
authors: ['samuelsycamore'] | ||
card: true | ||
tags: ['News'] | ||
--- | ||
|
||
With [v5.14.0](https://github.com/mui/material-ui/releases/tag/v5.14.0), MUI's Core component libraries—Material UI, Base UI, and Joy UI—are now compatible with the Next.js App Router. 🚀 | ||
|
||
<img alt="MUI and Next.js logos" src="/static/blog/mui-next-js-app-router/logos.png" loading="lazy" width="2076" height="900" /> | ||
|
||
## Adapting to the new paradigm | ||
|
||
React 18 introduced the concept of React Server Components, and Next.js 13 gave us the most mature framework implementation of RSCs to date with the App Router. | ||
While these two changes have caused major waves among the React community, it's clear that this is the path forward, and it's our responsibility as library maintainers to adapt to the new paradigm. | ||
|
||
As a first step towards this goal, we've updated all MUI Core components to ship with the `"use client"` directive, to let your apps know that these are Client Components (since Server Components are now the default). | ||
|
||
:::info | ||
**A note on terminology:** although MUI components cannot be used as React Server Components (RSCs) at this time, they _do_ support server-side rendering (SSR). | ||
See [this explanation of Client Components and SSR](https://github.com/reactwg/server-components/discussions/4) from the React Working Group for more details on the distinction between RSC and SSR. | ||
::: | ||
|
||
Additionally, we've created guides to walk you through setting up an app using the Next.js App Router with each of the Core libraries: | ||
|
||
- [Material UI setup](https://mui.com/material-ui/guides/next-js-app-router/) | ||
- [Base UI setup](https://mui.com/base-ui/guides/next-js-app-router/) | ||
- [Joy UI setup](https://mui.com/joy-ui/guides/next-js-app-router/) | ||
|
||
<img alt="Screenshot of the Material UI documentation" src="/static/blog/mui-next-js-app-router/docs.png" loading="lazy" width="2400" height="1394" style="margin-bottom:24px;" /> | ||
|
||
We also have example repos for each, with everything already set up for you: | ||
|
||
- [Material UI example](https://github.com/mui/material-ui/blob/master/examples/material-next-app-router-ts) | ||
- [Base UI with Tailwind CSS example](https://github.com/mui/material-ui/blob/master/examples/base-next-app-router-tailwind-ts) | ||
- [Joy UI example](https://github.com/mui/material-ui/blob/master/examples/joy-next-app-router-ts) | ||
|
||
## What comes next | ||
|
||
In the world of Server Components, "traditional" CSS-in-JS poses a serious challenge that may require us to move beyond Emotion, which is the default styling solution for Material UI and Joy UI in v5. | ||
We're currently exploring ways to offer our own zero-runtime CSS-in-JS solution that will enable you to use relevant MUI components as Server Components. | ||
This will also have the added benefit of improving performance across the board. | ||
Keep an eye out for an RFC from us very soon that will detail the proposed solution. | ||
|
||
In the meantime, please let us know if you have any questions or encounter any issues when using MUI components with the Next.js App Router. |
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.