El problema del monolito frontend
Los equipos de backend aprendieron a trabajar con microservicios hace años. Descompusieron los monolitos en servicios desplegables de forma independiente, cada uno a cargo de un equipo pequeño y con su propio ciclo de lanzamiento. El resultado fue una iteración más rápida, una responsabilidad más clara y menos cuellos de botella en los despliegues.
Los equipos de frontend, en su mayoría, no recibieron el mismo trato. Incluso en organizaciones con arquitecturas de backend sofisticadas, el frontend suele seguir siendo un único repositorio, un único pipeline de compilación y un único artefacto de despliegue. Todos los equipos que tocan la interfaz (el del dashboard, el del checkout, el del panel de administración) hacen commits en el mismo código, esperan el mismo pipeline de CI y despliegan juntos.
A pequeña escala, esto funciona bien. Con dos o tres desarrolladores frontend, la coordinación es manejable. Pero cuando cinco, ocho o doce equipos de frontend trabajan en distintas partes de la misma aplicación, el monolito se convierte en el cuello de botella. Una prueba rota en el módulo de checkout bloquea el despliegue del equipo del dashboard. La actualización de una dependencia por parte de un equipo rompe los componentes de otro. La planificación del sprint se vuelve una negociación por recursos compartidos en lugar de una priorización independiente.
Esta es la trampa del monolito frontend, y los micro-frontends son una forma de salir de ella.
Qué son realmente los micro-frontends
El concepto es sencillo: descomponer el frontend en piezas más pequeñas, que se desarrollan, prueban y despliegan de forma independiente. Cada pieza está a cargo de un solo equipo y corresponde a un dominio de negocio: el catálogo de productos, el perfil de usuario, el flujo de checkout, el panel de administración.
Cada micro-frontend puede usar su propio stack tecnológico, su propio pipeline de compilación y su propio calendario de lanzamientos. La aplicación contenedora, a veces llamada "shell" o "host", se encarga del enrutamiento, de la navegación compartida y de componer los micro-frontends individuales en una experiencia de usuario coherente.
Hay varios enfoques de implementación, cada uno con contrapartidas distintas:
Module Federation (Webpack 5 / Rspack)
Es el enfoque más popular para aplicaciones basadas en React. Cada micro-frontend es una compilación de Webpack independiente que expone componentes específicos. La aplicación host carga esos componentes en tiempo de ejecución desde URL separadas. Los equipos despliegan de forma independiente: cuando el equipo de checkout publica una versión nueva, la aplicación host la toma automáticamente sin necesidad de redesplegar.
La ventaja es el rendimiento. Las dependencias compartidas (React, el sistema de diseño) se cargan una sola vez y se comparten entre todos los micro-frontends. La experiencia del desarrollador se parece a la de un monolito: el hot module replacement funciona, los tipos de TypeScript se pueden compartir y el modelo mental resulta familiar.
La limitación es el acoplamiento. Todos los micro-frontends deben coincidir en la versión de React y en las principales dependencias compartidas. Actualizar React exige coordinar a todos los equipos, justo la coordinación que los micro-frontends deberían eliminar.
Single-SPA
Single-SPA adopta otro enfoque. Cada micro-frontend es una aplicación totalmente independiente, que incluso puede usar frameworks distintos. Un equipo puede usar React, otro Vue y otro Angular. El orquestador de single-spa monta y desmonta las aplicaciones según la ruta actual.
La ventaja es la independencia real. Los equipos toman decisiones tecnológicas sin coordinarse con nadie. Las actualizaciones de framework son decisiones locales.
El costo es el rendimiento. Cada framework suma al tamaño del bundle. Si tiene tres micro-frontends con tres versiones distintas de React, el usuario descarga React tres veces. En aplicaciones empresariales internas, donde el tamaño del bundle es menos crítico, esta contrapartida puede ser aceptable. En aplicaciones orientadas al consumidor, normalmente no lo es.
Composición del lado del servidor
En aplicaciones donde el SEO y el rendimiento de la carga inicial son primordiales, la composición del lado del servidor ensambla los micro-frontends en el edge o en el servidor antes de enviar el HTML al navegador. Es el enfoque que usan empresas como IKEA y Zalando en sus plataformas de comercio electrónico.
Cuándo tienen sentido los micro-frontends
Los micro-frontends añaden complejidad. No es una crítica: es un hecho que debe guiar las decisiones de adopción. La complejidad añadida solo se justifica cuando el dolor organizativo del monolito supera el costo técnico de descomponerlo.
Reglas empíricas de los proyectos que hemos entregado:
- 3 o más equipos de frontend independientes: por debajo de este umbral, la coordinación en un monolito es manejable. Por encima, los conflictos de despliegue y los cuellos de botella en los merges empiezan a consumir un tiempo de ingeniería considerable.
- Cadencias de lanzamiento distintas: si el equipo de marketing necesita actualizar la landing page a diario pero el producto principal se lanza cada dos semanas, obligarlos a seguir el mismo ciclo de lanzamiento genera una fricción innecesaria.
- Productos adquiridos: tras una adquisición, a menudo hay que integrar una aplicación recién adquirida en una plataforma existente. Los micro-frontends permiten incrustar la interfaz adquirida sin reescribirla.
- Migración gradual: ¿Está migrando de una aplicación Angular antigua a React? Los micro-frontends permiten reconstruir una sección a la vez mientras el resto de la aplicación sigue funcionando sin cambios.
Los micro-frontends no tienen sentido en equipos pequeños, productos en etapa inicial o aplicaciones donde un solo equipo es responsable de toda la interfaz. La carga de gestionar varios pipelines de compilación, versiones de dependencias compartidas y comunicación entre micro-frontends no es gratuita. Para un equipo de cuatro desarrolladores, un monolito bien estructurado con límites de módulos claros es casi siempre la mejor opción.
El sistema de diseño como elemento que une las piezas
El mayor riesgo de los micro-frontends es la fragmentación visual. Si cada equipo construye sus propios botones, sus propios campos de formulario y su propia paleta de colores, la experiencia de usuario se degrada en un mosaico inconsistente que parece cinco productos distintos cosidos entre sí.
La solución es un sistema de diseño compartido: una biblioteca de componentes que consumen todos los micro-frontends. No es opcional. Es la inversión más importante en una arquitectura de micro-frontends.
El sistema de diseño debe estar a cargo de un equipo dedicado (o de una guild rotativa) y publicarse como un paquete versionado. Los micro-frontends fijan una versión concreta y se actualizan según su propio calendario. Así se logra consistencia sin acoplamiento: los equipos usan los mismos botones y la misma tipografía y mantienen despliegues independientes.
En la práctica, publicamos los sistemas de diseño como paquetes npm y como documentación en Storybook. Cada componente se prueba visualmente con Chromatic, para asegurar que los cambios en el sistema de diseño no rompan por accidente los micro-frontends que dependen de él.
Rendimiento y consideraciones prácticas
El rendimiento en las arquitecturas de micro-frontends exige atención deliberada. Sin ella, se termina enviando más JavaScript, haciendo más solicitudes de red y ofreciendo una experiencia más lenta que la del monolito que se reemplazó.
Consideraciones clave:
- Deduplicación de dependencias compartidas: use el ámbito compartido de Module Federation para que bibliotecas como React y su sistema de diseño se carguen exactamente una vez, y no una por micro-frontend.
- Carga diferida (lazy loading): cargue un micro-frontend solo cuando el usuario navegue a su ruta. El módulo de checkout no tiene por qué estar en el bundle inicial si el usuario está explorando el catálogo de productos.
- Precarga (prefetching): anticipe la navegación del usuario y precargue el siguiente micro-frontend probable durante el tiempo de inactividad. Así se oculta la latencia de red de cargar un bundle aparte.
- Gestión del estado compartido: el estado entre micro-frontends debe ser mínimo. Use eventos o un mecanismo ligero de pub/sub en lugar de un store de Redux compartido. Cada micro-frontend debe ser dueño de su propio estado y comunicarse mediante contratos bien definidos.
La práctica de frontend de GTEMAS
En GTEMAS hemos entregado arquitecturas de micro-frontends para clientes empresariales de fintech, comercio electrónico y logística. Nuestro enfoque estándar usa Module Federation con un sistema de diseño compartido publicado en Storybook. Configuramos pipelines de CI/CD independientes por micro-frontend con GitHub Actions, y pruebas automatizadas de regresión visual con Chromatic.
No recomendamos los micro-frontends para todos los proyectos. Para muchos clientes, un monorepo bien estructurado con Turborepo o Nx da suficiente independencia a los equipos sin la carga operativa de varios despliegues. La arquitectura adecuada depende del tamaño del equipo, de la frecuencia de lanzamientos y de los problemas concretos que se quieran resolver.
Si su equipo de frontend está creciendo y la coordinación de los despliegues se está volviendo el cuello de botella, vale la pena conversar sobre micro-frontends. Podemos ayudarle a evaluar si la descomposición tiene sentido en su situación concreta y, si es así, a diseñar una arquitectura que dé independencia sin sacrificar la experiencia de usuario.
