front-end-assistant

front-end-assistant is a gulp assistant for those are working on sass, rtlcss, TFS .

By one task you can do the following on .scss file

• sass to css.
• css to rtlcss.
• checkout file for TFS.

Features

• Reduce the number of gulp tasks and Easy to use.
• Deal with postcss and autoprefix.
• Error handling, will display error on console and file its self.
• Configuration file for disable rtlcss or TFS.

Installation

Use the package manager to install front-end-assistant.

1npm install front-end-assistant

Usage

1const utility = import(front - end - assistant);
2
3var config = {
4  target: "front-end-assistant/Content/SASS/",
5  destnation: "front-end-assistant/Content/CSS/",
6};
7
8// for multiple files []
9gulp.task("sass-all", function () {
10  return utility.sass(config, ["**/**.scss"]);
11});
12
13// for single file
14gulp.task("sass-single", function () {
15  return utility.sass(config, "root.scss");
16});
17
18// for watching and update effected file only
19gulp.task("watch-All", function () {
20  return gulp.watch([config.target + "**/**.scss"]).on("change", function (file) {
21    var fileName = utility.getFileName(file);
22    var pathTarget = file.replace(fileName, "").replace(/\\/g, "/");
23    var destTarget = pathTarget.replace("SASS", "CSS");
24    return utility.sass(destTarget, pathTarget, fileName);
25  });
26});

Output

1
2├───project
3│    └───SASS
4│    │     ├───Layout.scss
5│    │     ├───Modules.scss
6│    │     └───Templates.scss
7
8/*auto generated by front-end-assistant*/
9
10│    └───CSS
11│		 ├───Layout.css
12│		 ├───Modules.css
13│		 └───Templates.css
14│
15│    └───CSS-RTL
16│		 ├───Layout.css
17│		 ├───Modules.css
18│		 └───Templates.css

Configuration

Configuration can be set using one of the following method

• Use a special file ui.config.json.

1{
2  "options": {
3    "rtl": true,
4    "tfs": true,
5    "rtl_path": "-RTL/" /*relative path to original 'config.destnation' path of css file */
6  }
7}

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

Author

Eskandar Hassan

• twitter/alexandar_hasan

License

MIT