Hacktoberfest 2026 : les issues que les mainteneurs ont marquées pour octobre, ouvertes et accessibles aux débutants. Parcourir les issues Hacktoberfest

user-client and admin-client are on different major versions of react-query, zustand, and mui-icons

Ouverte
#893 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Évaluation

Difficulté
4/5
Temps estimé
3-5 jours
Accessibilité débutants
48/100
Type d'issue
Refactorisation
Clarté
Plutôt claire
Activité
Calme
Stack technique
react, typescript

Piste de recherche

Start by comparing the dependency declarations and lockfile entries for user-client and admin-client; the issue does not name their manifest paths. First, assess the @mui/icons-material v5-to-v6 bump in admin-client, then inspect state and data-fetching usage before attempting the other upgrades. Done means the chosen package versions are aligned across clients and the affected client builds and tests pass.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

admin-client question tech debt user-client
Background

While setting up locally I noticed user-client and admin-client each carry their own node_modules folders (177 MB and 58 MB) while backend, common, and integrations do not.

The cause is that the two clients depend on different major versions of a few shared packages:

Package user-client admin-client
@tanstack/react-query ^5.56.2 ^4.10.1
zustand ^4.5.5 ^5.0.0
@mui/icons-material ^6.0.2 ^5.8.3

Yarn (with the node-modules linker declared in .yarnrc.yml) can only hoist one version of a given package to root. When workspaces disagree on the major version, one wins the root spot and the other gets a local copy in its own node_modules.

Nothing is broken today. Each workspace's imports resolve to the correct version via node's module resolution, and the two clients never share objects at runtime.

Problem

The two clients already share a substantial base: React 18, @mui/material v6.1.5, @emotion/react / @emotion/styled, react-hook-form v7, react-router-dom v6, immer v10. The three drifted packages sit directly on top of this shared foundation. Aligning them would give three concrete benefits:

  • Maintenance surface will keep growing. React Query v4 is essentially in maintenance mode. Security patches will taper off, adding to the same package-vulnerability churn flagged in #872.
  • Blocks shared React code in common. Because the underlying stack is already aligned, any shared React component, hook, or state helper could be extracted into common for reuse across both frontends. The current drift on these three specific packages blocks that.
  • API knowledge overhead. Anyone maintaining both frontends has to remember two API generations per library. React Query v4 → v5 in particular has meaningfully different syntax (object-syntax hooks, placeholderData replacing keepPreviousData, changed filter callbacks).
Proposed approach

Rather than a big-bang alignment project, do the migrations opportunistically as each area is touched. Ordered from lowest effort:

  • Bump @mui/icons-material in admin-client from v5 to v6. Trivial (icons are SVG components, near-zero API surface). Bonus: admin-client is already on @mui/material v6.1.5, so the current v5 icons combo is arguably an inconsistency worth fixing anyway.
  • Bump zustand in user-client from v4 to v5 next time someone touches user-client's state layer. Largely backward compatible.
  • Bump @tanstack/react-query in admin-client from v4 to v5 next time someone touches admin-client's data-fetching layer. Non-trivial — every useQuery / useMutation call needs review.

Alternatively, if the team prefers to knock all three out as one small tech-debt task, that also works.

Langage dominant
TypeScript
Étoiles
4
Forks
0
Merge moyen
14 h 50 min
PR mergées (30 j)
5

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de Garvan-Data-Science-Platform/ctrl

Toutes les issues de Garvan-Data-Science-Platform/ctrl

Issues similaires

Plus d'issues TypeScript

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.