CLI for organizing Tailwind CSS classes
npm install rustywindAvailable via npm
yarn global add rustywind
or
npm install -g rustywind
or
Install from homebrew (mac and linux):
brew install avencera/taps/rustywind
or
Install from a github release:
curl -LSfs https://avencera.github.io/rustywind/install.sh | sh -s -- --git avencera/rustywind
or
Download a release directly from github: github.com/avencera/rustywind/releases
or
You can use the dockerized version
docker run --rm -v $PWD:/app avencera/rustywind:latest
Run rustywind with a path to output updated file contents to the terminal:
- rustywind .
If you want to reorganize all classes in place, and change the files run with the --write flag
- rustywind --write .
Run rustywind with a path and the --dry-run to get a list of files that will be changed:
- rustywind --dry-run .
Run rustywind on your STDIN:
- echo "
Run in CI, exit with error if unsorted classes are found:
- rustywind --check-formatted .
Run RustyWind with a custom sorter. The config_file.json should have a top level entry of sortOrder
which is an array with the classes listed in the order you want them sorted.
- rustywind --config-file config_file.json
Use with tailwind prettier plugin
- rustywind --output-css-file
- rustywind --vite-css
``shell
Usage: rustywind [OPTIONS] [PATH]...
Run rustywind with a path to get a list of files that will be changed
rustywind . --dry-run
If you want to reorganize all classes in place, and change the files run with the --write flag
rustywind --write .
To print only the file names that would be changed run with the --check-formatted flag
rustywind --check-formatted .
If you want to run it on your STDIN, you can do:
echo "
Arguments:
[PATH]...
A file or directory to run on
Options:
--stdin
Uses stdin instead of a file or folder
--write
Changes the files in place with the reorganized classes
--dry-run
Prints out the new file content with the sorted classes to the terminal
--check-formatted
Checks if the files are already formatted, exits with 1 if not formatted
--allow-duplicates
When set, RustyWind will not delete duplicated classes
--config-file
When set, RustyWind will use the config file to derive configurations. The config file current only supports json with one property sortOrder, e.g. { "sortOrder": ["class1", ...] }
--output-css-file
When set RustyWind will determine the sort order by the order the class appear in the the given css file
--vite-css
When set RustyWind will determine the sort order by the order the class appear in the CSS file that vite generates.
Please provide the full URL to the CSS file ex: rustywind --vite-css "http://127.0.0.1:5173/src/assets/main.css" . --dry-run
Note: This option is experimental and may be removed in the future.
--skip-ssl-verification
When set, RustyWind will skip SSL verification for the vite_css option
--ignored-files
When set, RustyWind will ignore this list of files
--custom-regex
Uses a custom regex instead of default one
-h, --help
Print help (see a summary with '-h')
-V, --version
Print version
``
Inspired by Ryan Heybourn's headwind
vscode plugin. This is a CLI tool that will look through your project and sort all Tailwind CSS classes.
It will also delete any duplicate classes it finds.