search

mui / material-ui

Material UI: Comprehensive React component library that implements Google's Material Design. Free forever.
https://mui.com/material-ui/
MIT License
93.75k stars 32.24k forks source link

[material-ui][docs] Provide more details about why to use `material-nextjs` package in "Next.js integration" doc #40798

Open popey456963 opened 9 months ago

popey456963 commented 9 months ago

Related page

https://mui.com/material-ui/guides/nextjs/

Kind of issue

Missing information

Issue description

The documentation doesn't seem to specify what the difference is between material-nextjs and the default package. For those of us with an existing page router project are there reasons to convert, etc.

Context

I'm coming from an existing Next / MUI project and want to know how much I should priotitise the migration to the new package.

Search keywords: next integration

samuelsycamore commented 7 months ago

Hey @popey456963 ! Based on your description, it sounds like you may be confused about what the material-nextjs package is. It's not meant to be a replacement for any other package but rather a complementary package for integrating Material UI with Next.js. If you already have an app running fine with Next.js and Material UI, I would consider it a low priority to incorporate the integration package—though it may be useful in the future if/when we need to make changes on the Material UI side to better support Next.js. Does that make sense?

popey456963 commented 7 months ago

Thanks, that does make things clearer! Might be useful to still include it in the documentation as I can't imagine I'm the only person with an existing Next + MUI page looking to migrate :)

siriwatknp commented 2 months ago

Similar to #43267, the author missed to install Material UI before using the integration package.