wu-cli

npm install -g @wu-framework/cli

wu es un binario nativo escrito en Zig. Sin dependencias de Node y sin node_modules propio: entre 250 y 460 KB según la plataforma.

Esta página describe wu-cli 0.4. El instalador global requiere Node 16 o superior; en tiempo de ejecución, los frameworks con compilador propio (Vue, Svelte, Solid, Angular) piden Node 18+.

Qué resuelve

Un monorepo de microfrontends normalmente significa un servidor de desarrollo por aplicación. Seis micro-apps son seis procesos de Vite, seis puertos, una configuración raíz apuntando a todos ellos, y CORS de por medio porque cada uno vive en un origen distinto.

wu dev los sustituye por un proceso en un puerto:

wu dev
#   → Local:   http://127.0.0.1:3000/
#   → Apps:    shell  catalogo  carrito  perfil

Todo se sirve desde el mismo origen. No hay CORS que configurar porque no hay orígenes cruzados.

Cómo comparte dependencias

El servidor reescribe cada especificador desnudo a una ruta virtual:

import React from 'react';           // lo que escribes
import React from '/@modules/react'; // lo que recibe el navegador

Un resolver, un node_modules, y el navegador evalúa un módulo por URL. No hay singleton: true, ni requiredVersion, ni registro de scope compartido: la identidad viene de la URL.

Es la diferencia con Module Federation, que negocia versiones en tiempo de ejecución y arrastra una familia de errores propia. Aquí no hay negociación porque no hay nada que negociar.

wu build lleva esa misma propiedad a producción mediante un import map.

Comandos

Comando	Qué hace
wu create <nombre>	Genera un proyecto. 13 frameworks.
wu add <framework> <nombre>	Añade una micro-app a un proyecto existente.
wu install	Fusiona las dependencias de todas las apps y ejecuta un solo npm install.
wu dev	Servidor de desarrollo: un proceso, un puerto, HMR.
wu build	Construye cada app y las recoge en un dist/ unificado.
wu doctor	Diagnostica el proyecto: siete chequeos, de entradas rotas a credenciales a punto de publicarse.
wu serve	Sirve un dist/ ya construido, con cabeceras de seguridad.
wu info	Muestra la configuración detectada.

Opciones que conviene conocer

Comando	Opciones
wu dev	--port <n> / -p, --open / -o, --no-open, --native (por defecto), --vite (legado)
wu serve	El puerto va posicional: wu serve 8080. No acepta --port ni -p.
wu add	--no-install para encadenar varios add y cerrar con un solo wu install.
wu install	--force / -f sobrescribe un package.json raíz que wu no escribió.
wu create	--template <fw> y --shell <fw> — el shell admite además astro y next.

Usa wu install, no npm install a secas. Es el único que vuelve a fusionar las dependencias cuando cambias las de una micro-app, detecta conflictos de versión mayor y escribe el mapa que el servidor necesita para servir a cada app su propia versión.

Empezar

wu create mi-proyecto --template react
cd mi-proyecto
wu install
wu dev

Sin argumentos, wu create abre un asistente interactivo donde eliges el framework de cada micro-app y el del shell.