@vunojs/cli

CLI de Vuno para preparar, desarrollar, compilar e iniciar aplicaciones. El binario se llama vuno; debe ejecutarse desde la raíz de la aplicación que contiene vuno.config.ts.

Instalación

Requiere Node.js >=22.18.0. Una aplicación nueva lo trae con pnpm create vuno my-app; en una existente:

pnpm add -D @vunojs/cli @vunojs/core

Dentro del monorepo de Vuno, una aplicación del workspace usa pnpm --filter my-app add -D '@vunojs/cli@workspace:*'.

create-vuno ya declara la CLI en el proyecto que genera. No necesitas llamar directamente a @vunojs/vite o @vunojs/node para usarla.

Flujo habitual

pnpm exec vuno prepare   # Genera tipos, autoimports y otros archivos de app/.vuno
pnpm exec vuno dev       # Servidor de desarrollo con HMR
pnpm exec vuno build     # Build de producción
pnpm exec vuno preview   # Comprueba localmente ese build
pnpm exec vuno start     # Arranca el runtime de producción

prepare no crea páginas nuevas: genera los tipos y módulos a partir de lo que ya existe en app/, server/, shared/ y de los módulos configurados. dev también prepara la aplicación al arrancar. Si cambias la configuración o instalas un módulo y el editor mantiene tipos antiguos, ejecuta prepare y reinicia el servidor TypeScript del editor.

Para entender qué rutas se renderizan en servidor, se prerenderizan o quedan en el cliente:

pnpm exec vuno inspect rendering

Host, puerto y errores

dev, preview y start admiten --host[=<hostname>] y --port <number>; --open solo está disponible en dev y preview. Los flags tienen prioridad sobre vuno.config.ts. start, sin flags, busca VUNO_PORT, luego PORT y por último el puerto preview configurado; para la interfaz usa VUNO_HOST y después preview. Consulta vuno --help o vuno <comando> --help para la sintaxis completa.

Con el puerto configurado ocupado, dev arranca en el siguiente libre y lo muestra en la terminal. preview no se muda: si lo ocupa un servidor vuno anterior de este mismo proyecto, la CLI lo cierra y arranca en su lugar; si lo ocupa cualquier otro proceso, falla nombrándolo y no lo toca. start tampoco se muda ni cierra nada: falla, porque en producción ese proceso puede ser la versión anterior que todavía atiende tráfico.

vuno dev vuelve a cargar vuno.config.* y reinicia Vite cuando cambia. Una configuración inválida se informa sin cerrar el servidor anterior.

La referencia de la CLI explica cada comando; configuración detalla vuno.config.ts y despliegue distingue preview de start.