Fast, deterministic CSS linting for modern projects.

This project is a Rust-first linter focused on CI-safe behavior and first-class support for:

• .css
• .vue <style> blocks
• .svelte <style> blocks

It is currently in active development toward a scoped v1.

Current CLI

clint [path] [--config <path>] [--ignore-path <path>] [--targets <profile>] [--rule <rule_id>]... [--code-frame] [--profile] [--fix] [--format json|pretty] [--version|-v]

If path is omitted, clint defaults to ..

Core v1 commands:

• clint <path>
• clint <path> --fix
• clint <path> --format json
• clint <path> --rule <rule_id>
• clint --version

Exit codes:

• 0 no errors
• 1 lint errors found
• 2 runtime/config/internal failure

Install

From release binaries (no build):

curl -fsSL https://raw.githubusercontent.com/stolinski/csslint/main/scripts/install.sh | bash

The installer prefers the latest stable release and falls back to the newest tag when a stable asset for your platform is unavailable.

If the installer places clint in ~/.local/bin, make sure that directory is on your PATH:

export PATH="$HOME/.local/bin:$PATH"

Install a specific tag (including prereleases):

curl -fsSL https://raw.githubusercontent.com/stolinski/csslint/main/scripts/install.sh | bash -s -- --version v0.1.0-alpha.3

From this repo clone (build from source):

cargo install --path crates/csslint-cli --force

Or build locally and run from target:

cargo build --release
./target/release/clint --help

From GitHub Releases (after a tagged release):

1. Open the repo's latest release page.
2. Download the archive for your platform:
   • clint-linux-x86_64.tar.gz
   • clint-macos-arm64.tar.gz
   • clint-macos-x86_64.tar.gz
   • clint-windows-x86_64.zip
3. Verify checksum with the matching .sha256 file.
4. Extract and place clint (or clint.exe) on your PATH.

Quick try from extracted binary:

./clint --help
./clint /path/to/repo --format json

Quick Start

# lint
clint .
# print version
clint --version
# run only selected rule(s)
clint . --rule no_duplicate_selectors
# apply safe fixes
clint . --fix
# CI-friendly JSON output
clint . --format json

Config

v1 config file:

• file name: .csslint
• format: JSON only

See docs/plan/08-cli-and-config.md and docs/rule-catalog-v1.md for canonical rule and preset behavior.

Default rules enabled by v1 (recommended preset):

• no_unknown_properties (error)
• no_invalid_values (error)
• no_duplicate_selectors (error)
• no_duplicate_declarations (error)
• no_empty_rules (warn)
• no_legacy_vendor_prefixes (warn)
• no_overqualified_selectors (warn)
• prefer_logical_properties (warn)
• no_global_leaks (error)
• no_deprecated_features (warn)

Documentation

• Docs index: docs/README.md
• Plan and execution order: docs/plan/README.md
• Rule catalog and defaults: docs/rule-catalog-v1.md
• JSON output contract: docs/json-output-schema-v1.md