CLI
The command line interface for UnoCSS:@unocss/cli
.
- 🍱 Suited for traditional backends like Laravel or Kirby
- 👀Watch mode included
- 🔌 Supports custom configurations via
uno.config.ts
Installation
This package is shipped with theunocss
package:
pnpm add -D unocss
yarn add -D unocss
npm install -D unocss
bun add -D unocss
You can also install the standalone package:
pnpm add -D @unocss/cli
yarn add -D @unocss/cli
npm install -D @unocss/cli
bun add -D @unocss/cli
INFO
If you are not able to find the binary (e.g. withpnpm
and onlyunocss
is installed), you'll need to explicit install@unocss/cli
standalone package.
Usage
You can also pass multiple glob patterns to@unocss/cli
:
unocss "site/snippets/**/*.php" "site/templates/**/*.php"
Example package configuration:
INFO
Make sure to add escaped quotes to your npm script glob patterns.
{ "scripts": { "dev": "unocss\"site/{snippets,templates}/**/*.php\" --watch", "build": "unocss\"site/{snippets,templates}/**/*.php\"" }, "devDependencies": { "@unocss/cli": "latest" }}
Development
Add the--watch
(or-w
) flag to enable watching for file changes:
unocss "site/{snippets,templates}/**/*.php" --watch
Production
unocss "site/{snippets,templates}/**/*.php"
The finaluno.css
will be generated to the current directory by default.
Built-in features
Configurations
Create auno.config.js
oruno.config.ts
configuration file the root-level of your project to customize UnoCSS.
import { defineConfig } from 'unocss'export default defineConfig({ cli: { entry: {},// CliEntryItem | CliEntryItem[] }, // ...})interface CliEntryItem { /** * Glob patterns to match files */ patterns:string[] /** * The output filename for the generated UnoCSS file */ outFile:string}
For a list of options, head over to theUnoCSS configurations docs.
Options
Options | |
---|---|
-v, --version | Display the current version of UnoCSS |
-c, --config-file <file> | Config file |
-o, --out-file <file> | The output filename for the generated UnoCSS file. Defaults touno.css in the current working directory |
--stdout | Write the generated UnoCSS file to STDOUT. Will cause the--watch and--out-file being ignored |
-w, --watch | Indicates if the files found by the glob pattern should be watched |
--preflights | Enable preflight styles |
--write-transformed | Update source files with transformed utilities |
-m, --minify | Minify generated CSS |
-h, --help | Display available CLI options |