# Qué hace WU CLI

Entiende cómo la CLI prepara un proyecto WU y te acompaña desde la primera app hasta los archivos de producción.

Consulta las versiones, cambios y requisitos en [Framework 4.0 y CLI 1.2](/es/docs/guides/releases/).


WU CLI es la herramienta de terminal que prepara y desarrolla proyectos WU. Con el comando `wu` puedes crear la página que reúne tus aplicaciones, añadir una app, iniciar el desarrollo y construir los archivos que vas a publicar.

<span class="section-anchor" id="section-1"></span>

## El trabajo que te ahorra

Una aplicación React y otra Vue tienen sus componentes, dependencias y comandos de compilación. Para mostrarlas juntas también necesitas un **shell**: la página que reserva sus espacios y decide cuándo aparecen.

La CLI genera esa estructura y guarda la relación entre shell y apps en `wu.config.json`. La carpeta que los reúne se llama **workspace**. Desde su raíz puedes instalar las dependencias del proyecto, acceder al desarrollo por un mismo origen HTTP y reunir los builds en `dist/`.

<span class="section-anchor" id="section-2"></span>

## CLI y framework tienen trabajos distintos

| Herramienta | Dónde la utilizas | Qué hace |
| --- | --- | --- |
| `@wu-framework/cli` | En la terminal, mediante `wu` | Genera archivos, instala dependencias, desarrolla y construye el proyecto. |
| `wu-framework` | En el código de la aplicación | Carga y monta las apps; coordina eventos, estado, llamadas y permisos. |

La CLI prepara el proyecto que abre el usuario; el runtime sigue coordinando las apps cuando ese proyecto está publicado. Si aún no conoces la relación entre app, shell y runtime, empieza por [Qué es WU](/es/docs/framework/overview/).

<span class="section-anchor" id="section-3"></span>

## El recorrido habitual

Empieza con una sola app y comprueba que aparece en el shell. Añade más cuando ya puedas reconocer las piezas del proyecto.

| Paso | Comando | Resultado que debes reconocer |
| --- | --- | --- |
| Crear | `wu create` | Una carpeta con el shell, la primera microapp y `wu.config.json`. |
| Instalar | `wu install` | Dependencias preparadas para los comandos del proyecto. |
| Desarrollar | `wu dev` | El shell y las apps accesibles en el navegador durante el desarrollo. |
| Añadir otra app | `wu add <framework> <name>` | Una nueva carpeta de app y su entrada en la configuración. |
| Construir | `wu build` | Los archivos de producción reunidos en `dist/`. |
| Revisar producción | `wu serve 4100` | El contenido de `dist/` servido localmente por HTTP. |

Puedes repetir el ciclo **añadir → instalar cuando corresponda → desarrollar** antes de construir. `wu add` intenta instalar por defecto; con `--no-install` aplazas la instalación hasta ejecutar `wu install`.

`wu serve` permite revisar lo construido. Para publicarlo, entregas los archivos de `dist/` a tu plataforma de hosting; la CLI no incluye un comando `deploy`.

<span class="section-anchor" id="section-4"></span>

## Hazlo paso a paso

1. [Tu primera app](/es/docs/guides/quickstart/): prepara el entorno, genera el shell y comprueba una microapp en el navegador.
2. [Añade otra app](/es/docs/guides/add-an-app/): incorpora otro framework y distingue sus archivos de los de la primera app.
3. [Prepara producción](/es/docs/guides/production/): construye, sirve el resultado y comprueba lo que vas a publicar.

Las plantillas de CLI `1.2.0` declaran `wu-framework: ^4.0.0`. Consulta [Instalación y versiones](/es/docs/cli/installation/).

<span class="section-anchor" id="section-5"></span>

## Dónde trabajar dentro del proyecto

| Archivo o directorio | Qué encontrarás allí |
| --- | --- |
| `wu.config.json` | La relación entre shell y apps, sus comandos y las opciones del workspace. |
| `shell/` | La página anfitriona y su navegación. |
| `mf-*/` | Los componentes y dependencias de cada microapp. |
| `dist/` | El resultado de `wu build`, preparado para revisar y publicar. |

Edita las fuentes de `shell/` o de la microapp que corresponda. El contenido de `dist/` vuelve a generarse en cada build. [Configuración](/es/docs/cli/configuration/) explica los campos de `wu.config.json`; [Crear](/es/docs/cli/create/) y [Añadir](/es/docs/cli/add/) detallan las opciones de los generadores.

<span class="section-anchor" id="section-6"></span>

## Cuando necesites consultar un comando

Usa `wu --help` para ver la ayuda general y `wu --version` para comprobar la versión. Para revisar un proyecto, `wu info` muestra la configuración detectada y [wu doctor](/es/docs/cli/doctor/) inspecciona su coherencia.

La [referencia de comandos](/es/docs/cli/api-reference/) reúne argumentos, resultados y límites. Estas son las opciones reconocidas en la versión documentada:

La CLI incluye `wu catalog` para consultar las versiones generadas y `wu upgrade` para migrar manifiestos y plantillas existentes. `wu update` actualiza la CLI; `wu upgrade` prepara el proyecto; `wu install` instala sus dependencias. Consulta el [recorrido de migración](/es/docs/cli/dependencies/).