@strato-css/cli

CLI tool for Strato CSS framework. Provides command-line utilities for building, inspecting, and managing Strato CSS projects.

Installation

``bash
pnpm add -g @strato-css/cli
`

Or use directly with npx:

`bash
npx @strato-css/cli build
`

Commands

$3

Compile CSS from your source files.

`bash
strato build
`

Options:
- -c, --config - Path to config file (default: strato.config.js)
- -o, --output - Output CSS file path (default: strato.css)
- -w, --watch - Watch mode for development
- -m, --minify - Minify output CSS
- --include - File patterns to include (default: src/*/.{html,js,ts,jsx,tsx,vue,svelte})
- --exclude - File patterns to exclude (default: node_modules,dist,build)

Examples:

`bash


Basic build

strato build

Custom output

strato build -o dist/styles.css

Watch mode

strato build -w

Minify output

strato build -m

Custom config

strato build -c strato.config.js

With custom includes

strato build --include "src//.tsx" --include "src//.jsx"
`

$3

Inspect and analyze utility classes.

`bash
strato inspect
`

Examples:

`bash


Inspect single class

strato inspect p-4

Inspect multiple classes

strato inspect "p-4 bg-white rounded"

Analyze generated CSS

strato inspect "hover:bg-primary focus:ring-2"
`

$3

Initialize a new Strato CSS project.

`bash
strato init
`

Options:
- -t, --template - Template to use (default: default)
- --yes - Skip prompts

Examples:

`bash


Interactive init

strato init

Use specific template

strato init -t react

Skip prompts

strato init --yes
`

Creates:
- strato.config.js - Configuration file
- strato.css - Generated CSS
- Updates package.json with scripts

$3

Show CLI and framework version information.

`bash
strato version
`

Output:
`
@strato-css/cli: 0.0.1
@strato-css/core: 0.0.1
Node.js: v18.19.0
`

Configuration

Create a strato.config.js file in your project root:

`javascript
export default {
// Presets
presets: [],

// Theme customization
theme: {
colors: {
primary: '#3b82f6',
secondary: '#10b981'
}
},

// Additional rules
rules: [],

// Shortcuts
shortcuts: {},

// Include patterns
include: ['src/*/.{html,js,ts,jsx,tsx,vue,svelte}'],

// Exclude patterns
exclude: ['node_modules', 'dist', 'build']
};
`

Examples

$3

`bash


Initialize project

strato init

Build CSS

strato build

Watch for changes

strato build -w
`

$3

`bash


Build with custom config

strato build -c config/strato.js

Build with custom output

strato build -o assets/styles.css

Build with minification

strato build -m
`

$3

`bash


Terminal 1: Watch mode

strato build -w

Terminal 2: Development server

npm run dev
`

Package.json Scripts

Add scripts to your package.json:

`json
{
"scripts": {
"build:css": "strato build",
"watch:css": "strato build -w",
"build:css:prod": "strato build -m"
}
}
`

Development

$3

`bash


Run all tests

pnpm test

Run tests in watch mode

pnpm test --watch

Run tests with UI

pnpm test:ui

Run tests with coverage

pnpm test:coverage
`

$3

`bash


Build the CLI

pnpm build

Build in watch mode

pnpm dev
`

$3

`bash


Run TypeScript type checking


pnpm typecheck
`

Help

Get help on any command:

`bash
strato --help
strato build --help
strato inspect --help
strato init --help
strato version --help
``

License

MIT