https://github.com/debba/less2scss
Convert less files in scss on the fly.
https://github.com/debba/less2scss
cli converter less node npm scss style
Last synced: 5 months ago
JSON representation
Convert less files in scss on the fly.
- Host: GitHub
- URL: https://github.com/debba/less2scss
- Owner: debba
- License: apache-2.0
- Created: 2019-03-24T14:33:52.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2023-05-26T05:10:42.000Z (about 3 years ago)
- Last Synced: 2025-11-02T18:14:23.665Z (8 months ago)
- Topics: cli, converter, less, node, npm, scss, style
- Language: JavaScript
- Homepage:
- Size: 295 KB
- Stars: 40
- Watchers: 2
- Forks: 6
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://nodei.co/npm/less2scss.png/)
[](https://badge.fury.io/js/less2scss)
less2scss
-------------------
This npm package will convert all your less files to scss.
You can provide an entire folder, this package will scan all less files whose find in subfolders and it'll create SCSS files in the same folder or in the new directory provided recreating the source hierarchy.
Install
-------------
Install it via npm:
```bash
$ npm install less2scss --global
```
Usage
------
`less2scss` offers a single command line interface:
```bash
$ less2scss
```
Will print an help:
```
Usage: less2scss [options]
This utility quickly converts all your less files to scss.
Options:
-V, --version output the version number
-s, --src comma separated source paths
-d, --dst destination path
-e, --exclude comma separated exclude paths
-r, --recursive allow to recursively walk directories (default: false)
-h, --help display help for command
```
Options
--------
You can pass the following options via CLI arguments.
| Description | Short command | Full command | Mandatory | Default value |
| --------------------------------------------------------------------------------------------------------------------------------------- | ------------- | ------------------ | ------------------ | ------------------ |
| Comma separated LESS files and paths | `-s` | `--src` | Yes | - |
| Destination path for converted SCSS files (if provided). If not provided, it will be the same directory | `-d` | `--dst` | No | Same directory of files provided |
| Comma separated exclude paths | `-e` | `--exclude` | No | - |
| Allow to recursively walk directories | `-r` | `--recursive` | No | false |
**Note:**
For excluding files and path we use [ignore](https://www.npmjs.com/package/ignore) package.
_`ignore` is a manager, filter and parser which implemented in pure JavaScript according to the .gitignore spec 2.22.1.
**All paths provided must be relative to the source path**
Examples
--------
#### Convert LESS files inside a folder excluding `node_modules` and `vendor` subfolders.
```bash
$ less2scss -s ./less_folder -d ./scss_folder -r -e 'node_modules,vendor'
```
#### Convert LESS files inside a folder excluding all subfolders whose name begins with `test`.
```bash
$ less2scss -s ./less_folder -d ./scss_folder -r -e 'node_modules,vendor'
```
Notice
--------
Be careful, something may not be converted properly.
It's an automatic conversion tool, you can fix errors manually later.
Credits
--------
Some convertion rules are inspired by:
- [Gulp Less to Scss](https://github.com/steelydylan/gulp-less-to-scss]) by steelydylan .
- [Less Scss Convertor](https://github.com/tarun29061990/less-scss-convertor) by
tarun29061990 .
Contributing
--------
If you have suggestions for enhancements or ideas for new features that could be useful, please open a pull request or open an issue.
License
--------
less2scss is licensed under : The Apache Software License, Version 2.0. You can find a copy of the license (http://www.apache.org/licenses/LICENSE-2.0.txt)
Enjoy ;)