Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

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

Abierto
#893 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
4/5
Tiempo estimado
3-5 días
Aptitud para principiantes
48/100
Tipo de issue
Refactorización
Claridad
Bastante claro
Estado de actividad
Tranquilo
Stack tecnológico
react, typescript

Línea de trabajo

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.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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.

Lenguaje dominante
TypeScript
Estrellas
4
Forks
0
Merge medio
14 h 50 min
PR fusionados (30 d)
5

Preparar el entorno

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de Garvan-Data-Science-Platform/ctrl

Todos los issues de Garvan-Data-Science-Platform/ctrl

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.