Estrategias de monorepo para el desarrollo web

Monorepos: Gestión de múltiples proyectos en un solo repositorio

Un monorepo es un único repositorio de Git que contiene múltiples proyectos. En lugar de tener repositorios separados para tu frontend, backend, bibliotecas compartidas y documentación, los mantienes todos en un solo lugar. Este enfoque fue pionero en Google, Meta y Microsoft, y ahora es popular entre equipos de todos los tamaños.

Por qué usar un monorepo

La principal ventaja es compartir código. Cuando tu frontend y backend comparten tipos de TypeScript, puedes definirlos una vez y usarlos en todas partes. Las funciones de utilidad compartidas, los esquemas de validación y los archivos de configuración viven en un solo lugar. Un cambio que afecta a múltiples proyectos se puede realizar en un solo commit, en lugar de coordinar entre múltiples repositorios.

Los commits atómicos son otro beneficio. Cuando cambias un endpoint de API y necesitas actualizar el frontend para que coincida, lo haces en un solo commit. Sin problemas de sincronización, sin desajustes de versiones. Las revisiones de código muestran la imagen completa del cambio. Y la refactorización a través de los límites del proyecto es sencilla.

Las herramientas

Varias herramientas hacen prácticos los monorepos. Nx es un potente sistema de compilación con almacenamiento en caché inteligente, conocimiento del gráfico de dependencias y soporte para muchos frameworks. Turborepo es más simple y se centra en el almacenamiento en caché y la orquestación de tareas. Los espacios de trabajo de pnpm y los espacios de trabajo de Yarn proporcionan soporte básico para monorepos con enlace de paquetes.

Estas herramientas entienden qué proyectos dependen de cuáles, y pueden ejecutar solo las pruebas y compilaciones que se ven afectadas por un cambio. Esto hace que los monorepos sean rápidos incluso cuando crecen.

Organizar un monorepo

Una estructura típica de monorepo coloca el código compartido en un directorio packages, las aplicaciones en un directorio apps y la configuración de las herramientas en la raíz. Cada paquete tiene su propio package.json, configuración de TypeScript y pruebas. La configuración raíz establece estándares compartidos para linting, formateo y pruebas.

La propiedad clara es importante. Aunque el código vive en un solo repositorio, diferentes equipos pueden ser propietarios de diferentes paquetes. Los archivos CODEOWNERS definen quién es responsable de qué. Los pipelines de CI se pueden configurar para ejecutar diferentes comprobaciones según los archivos que cambiaron.

Desafíos potenciales

Los monorepos no están exentos de desafíos. El tamaño del repositorio puede crecer, aunque Git moderno maneja esto bien. El CI debe ser inteligente para construir solo los proyectos modificados. El control de acceso es más matizado: no puedes dar acceso a solo una parte del repositorio. Y la configuración de las herramientas es más compleja que la de un repositorio simple de un solo proyecto.

Para la mayoría de los equipos, los beneficios del intercambio de código y los commits atómicos superan los desafíos. La clave es usar las herramientas adecuadas y establecer convenciones claras sobre cómo se organiza el repositorio.