# O que a WU CLI faz

Entenda como a CLI prepara um projeto WU e acompanha você desde a primeira app até os arquivos de produção.

Veja versões, mudanças e requisitos em [Framework 4.0 e CLI 1.2](/pt/docs/guides/releases/).


A WU CLI é a ferramenta de terminal que prepara e desenvolve projetos WU. Com o comando `wu`, você pode criar a página que reúne suas aplicações, adicionar uma app, iniciar o desenvolvimento e construir os arquivos que serão publicados.

<span id="el-trabajo-que-te-ahorra"></span>

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

## O trabalho que ela poupa

Uma aplicação React e outra Vue têm seus componentes, dependências e comandos de compilação. Para mostrá-las juntas, você também precisa de um **shell**: a página que reserva seus espaços e decide quando aparecem.

A CLI gera essa estrutura e salva a relação entre shell e apps em `wu.config.json`. A pasta que os reúne se chama **workspace**. A partir de sua raiz, você pode instalar as dependências do projeto, acessar o desenvolvimento por uma mesma origem HTTP e reunir os builds em `dist/`.

<span id="cli-y-framework-tienen-trabajos-distintos"></span>

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

## CLI e framework têm trabalhos diferentes

| Ferramenta | Onde você a utiliza | O que faz |
| --- | --- | --- |
| `@wu-framework/cli` | No terminal, por meio de `wu` | Gera arquivos, instala dependências, desenvolve e constrói o projeto. |
| `wu-framework` | No código da aplicação | Carrega e monta as apps; coordena eventos, estado, chamadas e permissões. |

A CLI prepara o projeto que o usuário abre; o runtime continua coordenando as apps quando esse projeto está publicado. Se você ainda não conhece a relação entre app, shell e runtime, comece por [O que é WU](/pt/docs/framework/overview/).

<span id="el-recorrido-habitual"></span>

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

## O percurso habitual

Comece com uma única app e verifique se ela aparece no shell. Adicione mais quando já conseguir reconhecer as partes do projeto.

| Etapa | Comando | Resultado que você deve reconhecer |
| --- | --- | --- |
| Criar | `wu create` | Uma pasta com o shell, a primeira microapp e `wu.config.json`. |
| Instalar | `wu install` | Dependências preparadas para os comandos do projeto. |
| Desenvolver | `wu dev` | O shell e as apps acessíveis no navegador durante o desenvolvimento. |
| Adicionar outra app | `wu add <framework> <name>` | Uma nova pasta de app e sua entrada na configuração. |
| Construir | `wu build` | Os arquivos de produção reunidos em `dist/`. |
| Revisar a produção | `wu serve 4100` | O conteúdo de `dist/` servido localmente por HTTP. |

Você pode repetir o ciclo **adicionar → instalar quando aplicável → desenvolver** antes de construir. `wu add` tenta instalar por padrão; com `--no-install`, você adia a instalação até executar `wu install`.

`wu serve` permite revisar o que foi construído. Para publicar, você entrega os arquivos de `dist/` à sua plataforma de hospedagem; a CLI não inclui um comando `deploy`.

<span id="hazlo-paso-a-paso"></span>

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

## Faça passo a passo

1. [Sua primeira app](/pt/docs/guides/quickstart/): prepare o ambiente, gere o shell e verifique uma microapp no navegador.
2. [Adicione outra app](/pt/docs/guides/add-an-app/): inclua outro framework e diferencie seus arquivos dos da primeira app.
3. [Prepare a produção](/pt/docs/guides/production/): construa, sirva o resultado e verifique o que será publicado.

Os templates da CLI `1.2.0` declaram `wu-framework: ^4.0.0`. Consulte [Instalação e versões](/pt/docs/cli/installation/).

<span id="dónde-trabajar-dentro-del-proyecto"></span>

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

## Onde trabalhar dentro do projeto

| Arquivo ou diretório | O que você encontrará ali |
| --- | --- |
| `wu.config.json` | A relação entre shell e apps, seus comandos e as opções do workspace. |
| `shell/` | A página anfitriã e sua navegação. |
| `mf-*/` | Os componentes e as dependências de cada microapp. |
| `dist/` | O resultado de `wu build`, preparado para revisar e publicar. |

Edite as fontes de `shell/` ou da microapp correspondente. O conteúdo de `dist/` é gerado novamente a cada build. [Configuração](/pt/docs/cli/configuration/) explica os campos de `wu.config.json`; [Criar](/pt/docs/cli/create/) e [Adicionar](/pt/docs/cli/add/) detalham as opções dos geradores.

<span id="cuando-necesites-consultar-un-comando"></span>

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

## Quando precisar consultar um comando

Use `wu --help` para ver a ajuda geral e `wu --version` para verificar a versão. Para revisar um projeto, `wu info` mostra a configuração detectada e [wu doctor](/pt/docs/cli/doctor/) inspeciona sua coerência.

A [referência de comandos](/pt/docs/cli/api-reference/) reúne argumentos, resultados e limites. Estas são as opções reconhecidas na versão documentada:

A CLI inclui `wu catalog` para consultar versões geradas e `wu upgrade` para migrar manifestos e templates existentes. `wu update` atualiza a CLI; `wu upgrade` prepara o projeto; `wu install` instala suas dependências. Consulte o [percurso de migração](/pt/docs/cli/dependencies/).