CLI

A interface de linha de comando para UnoCSS: @unocss/cli.

• 🍱 Adequado para backends tradicionais como Laravel ou Kirby
• 👀 Modo de observação incluído
• 🔌 Suporta configurações personalizadas via uno.config.ts

Instalação

Este pacote é fornecido com o pacote unocss:

pnpm

pnpm add -D unocss

yarn

yarn add -D unocss

npm

npm install -D unocss

bun

bun add -D unocss

Você também pode instalar o pacote autônomo:

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

Se você não conseguir encontrar o binário (por exemplo, com pnpm e apenas unocss instalado), precisará instalar explicitamente o pacote autônomo @unocss/cli.

Uso

Você também pode passar vários padrões glob para @unocss/cli:

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

Exemplo de configuração de pacote:

INFO

Certifique-se de adicionar aspas escapadas aos padrões glob do seu script npm.

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

Desenvolvimento

Adicione a flag --watch (ou -w) para habilitar a observação de alterações de arquivos:

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

Produção

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

O uno.css final será gerado no diretório atual por padrão.

Recursos integrados

Configurações

Crie um arquivo de configuração uno.config.js ou uno.config.ts no nível raiz do seu projeto para personalizar o UnoCSS.

import { defineConfig } from 'unocss'

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

interface CliEntryItem {
  /**
   * Padrões glob para corresponder a arquivos
   */
  patterns: string[]
  /**
   * O nome do arquivo de saída para o arquivo UnoCSS gerado
   */
  outFile: string
}

Para uma lista de opções, consulte a documentação de configurações do UnoCSS.

Opções

Opções
-v, --version	Exibir a versão atual do UnoCSS
-c, --config-file <file>	Arquivo de configuração
-o, --out-file <file>	O nome do arquivo de saída para o arquivo UnoCSS gerado. Por padrão, uno.css no diretório de trabalho atual
--stdout	Gravar o arquivo UnoCSS gerado no STDOUT. Fará com que --watch e --out-file sejam ignorados
-w, --watch	Indica se os arquivos encontrados pelo padrão glob devem ser observados
--preflights	Habilitar estilos de preflight
--write-transformed	Atualizar arquivos de origem com utilitários transformados
-m, --minify	Minificar CSS gerado
-h, --help	Exibir opções de CLI disponíveis