multei / multei/web

feat(deps): migrate Material UI v4 to MUI v5

Open
#436 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
JavaScript
Stars
3
Forks
2
PR merge metrics
No merged PRs in 30d

Description

Context

Renovate PR #409 tried to replace @material-ui/core with @mui/material, but this repository still uses the Material UI v4 package family throughout the codebase.

A package-only replacement is unsafe because the app still imports @material-ui/core, and related v4 packages remain in use:

  • @material-ui/core
  • @material-ui/icons
  • @material-ui/lab
  • @material-ui/styles
  • gatsby-plugin-material-ui

Scope

  • Audit all Material UI v4 imports and theme usage.
  • Plan the migration path to MUI v5 equivalents.
  • Update package dependencies as a coordinated migration, not a Renovate-only package swap.
  • Update Gatsby integration for MUI v5.
  • Run unit tests and a local build/dev smoke test.

Acceptance Criteria

  • No imports from @material-ui/* remain unless intentionally retained and documented.
  • MUI v5 packages are installed and compatible with the app's React/Gatsby stack.
  • Theme/provider setup works with MUI v5.
  • npm test passes.
  • A build/dev smoke test passes or any blocker is documented in TROUBLESHOOTING.md.

Related

  • Blocks #409

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by auditing the repository for imports from the listed @material-ui packages, theme/provider setup, and Gatsby integration. Review the dependency changes related to Renovate PR #409, then run npm test and a local build/dev smoke test. Done means MUI v5 is installed compatibly, no unintended v4 imports remain, tests pass, and any smoke-test blocker is documented in TROUBLESHOOTING.md.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript, react
Domain
build-system, frontend
Issue type
Refactor
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
42/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.