CLI

La interfaz de línea de comandos para UnoCSS: @unocss/cli.

• 🍱 Adecuado para backends tradicionales como Laravel o Kirby
• 👀 Modo watch incluido
• 🔌 Soporta configuraciones personalizadas a través de uno.config.ts

Instalación

Este paquete viene incluido con el paquete unocss:

pnpm

pnpm add -D unocss

yarn

yarn add -D unocss

npm

npm install -D unocss

bun

bun add -D unocss

También puedes instalar el paquete independiente:

pnpm

pnpm add -D @unocss/cli

yarn

yarn add -D @unocss/cli

npm

npm install -D @unocss/cli

bun

bun add -D @unocss/cli

INFO

Si no puedes encontrar el binario (ej. con pnpm y solo unocss está instalado), necesitarás instalar explícitamente el paquete independiente @unocss/cli.

Uso

También puedes pasar múltiples patrones glob a @unocss/cli:

unocss "site/snippets/**/*.php" "site/templates/**/*.php"

Ejemplo de configuración de paquete:

INFO

Asegúrate de agregar comillas escapadas a tus patrones glob de script npm.

{
  "scripts": {
    "dev": "unocss \"site/{snippets,templates}/**/*.php\" --watch",
    "build": "unocss \"site/{snippets,templates}/**/*.php\""
  },
  "devDependencies": {
    "@unocss/cli": "latest"
  }
}

Desarrollo

Agrega la bandera --watch (o -w) para habilitar la observación de cambios de archivos:

unocss "site/{snippets,templates}/**/*.php" --watch

Producción

unocss "site/{snippets,templates}/**/*.php"

El uno.css final se generará en el directorio actual por defecto.

Características integradas

Configuraciones

Crea un archivo de configuración uno.config.js o uno.config.ts en el nivel raíz de tu proyecto para personalizar UnoCSS.

import { defineConfig } from 'unocss'

export default defineConfig({
  cli: {
    entry: {}, // CliEntryItem | CliEntryItem[]
  },
  // ...
})

interface CliEntryItem {
  /**
   * Patrones glob para hacer coincidir archivos
   */
  patterns: string[]
  /**
   * El nombre del archivo de salida para el archivo UnoCSS generado
   */
  outFile: string
}

Para una lista de opciones, consulta la documentación de configuraciones de UnoCSS.

Opciones

Opciones
-v, --version	Mostrar la versión actual de UnoCSS
-c, --config-file <file>	Archivo de configuración
-o, --out-file <file>	El nombre del archivo de salida para el archivo UnoCSS generado. Por defecto es uno.css en el directorio de trabajo actual
--stdout	Escribir el archivo UnoCSS generado a STDOUT. Causará que --watch y --out-file sean ignorados
-w, --watch	Indica si los archivos encontrados por el patrón glob deben ser observados
--preflights	Habilitar estilos de preflight
--write-transformed	Actualizar archivos fuente con utilidades transformadas
-m, --minify	Minificar CSS generado
-h, --help	Mostrar opciones CLI disponibles