
Skill
material-ui-nextjs
integrate Material UI with Next.js
Published by MUI (Material UI) Updated Jul 14
Covers React Next.js Tailwind CSS UI Components Frontend
Description
Integrates Material UI with Next.js App and Pages routers using @mui/material-nextjs, Emotion cache providers, next/font, CSS layers with Tailwind/CSS Modules, Link component prop patterns, CSS theme variables SSR notes, and App Router useSearchParams + Suspense. Use when setting up or debugging MUI in a Next.js app.
SKILL.md
Material UI and Next.js
Agent skill for Next.js + Material UI wiring (SSR/streaming, cache providers, fonts, layers, Link, App Router URL state). SKILL.md is the entry; AGENTS.md is the full guide.
When to apply
- New App Router or Pages Router app using
@mui/material - Styles missing, wrong order, or in
bodyinstead ofhead next/font+ThemeProvider/createTheme- Tailwind or CSS Modules + MUI (
enableCssLayer) Button+component={Link}or Next.js v16 client boundary errorsuseSearchParams/ URL-driven MUI views and Suspense boundaries
Sections in AGENTS.md
| Area | Topics |
|---|---|
| App Router | AppRouterCacheProvider, @emotion/cache, options, useSearchParams + <Suspense> |
| Pages Router | _document, _app, DocumentHeadTags, AppCacheProvider |
| Fonts | 'use client' theme, next/font, CSS variables on html |
| CSS variables | cssVariables, SSR flicker docs |
| CSS layers | enableCssLayer, Tailwind / other CSS |
| Link | Client wrapper, routing guide, examples repo |
Full guide
Read AGENTS.md for complete steps and doc links.
reference.md lists import paths and provider shape.
More skills from the material-ui repository
View all 4 skillsSkillTagsUpdated