https://github.com/laurenhamel/grunt-dart-sass

Compile Sass to CSS via Dart Sass
https://github.com/laurenhamel/grunt-dart-sass

Last synced: 6 days ago
JSON representation

Compile Sass to CSS via Dart Sass

• Host: GitHub
• URL: https://github.com/laurenhamel/grunt-dart-sass
• Owner: laurenhamel
• Created: 2018-06-06T13:54:29.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2024-03-12T09:52:08.000Z (8 months ago)
• Last Synced: 2024-09-19T03:36:12.327Z (2 months ago)
• Language: JavaScript
• Size: 252 KB
• Stars: 13
• Watchers: 1
• Forks: 4
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# grunt-dart-sass

> Compile Sass to CSS via Dart Sass

## Getting Started

If you haven't used [Grunt](http://gruntjs.com/) before, be sure to check out the [Getting Started](http://gruntjs.com/getting-started) guide, as it explains how to create a [Gruntfile](http://gruntjs.com/sample-gruntfile) as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

```

npm install -D sass grunt-dart-sass

```

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

```

grunt.loadNpmTasks('grunt-dart-sass');

```

## Usage

Run this task with the `grunt dart-sass` command.

## Options

Refer to the [Dart Sass JavaScript API](https://github.com/sass/dart-sass#javascript-api) for more information about options and guidelines for proper usage. [Dart Sass](https://github.com/sass/dart-sass) options are similar to the those of [Node-sass](https://github.com/sass/node-sass), excluding `precision` and `sourceComments` options and sans the `nested` and `compact` values for the `outputStyle` option.

## Examples

Add a section named `dart-sass` to the data object passed into `grunt.initConfig()`, then pass in your files object or array.

**Compile a file**

```js

grunt.initConfig({

  'dart-sass': {

    target: {

      files: {

        'dest/css/style.css': 'src/scss/style.scss'

      }

    }

  }

});

```

**Compile all files within a folder**

```js

grunt.initConfig({

  'dart-sass': {

    target: {

      files: [{

        expand: true,

        cwd: 'src/scss/',

        src: ['*.scss'],

        dest: 'dest/css',

        ext: '.css'

      }]

    }

  }

});

```

**Compress the CSS output**

```js

grunt.initConfig({

  'dart-sass': {

    target: {

      options: {

        outputStyle: 'compressed'

      },

      files: {

        'dest/css/style.css': 'src/scss/style.scss'

      }

    }

  }

});

```

**Prevent the creation of source maps**

```js

grunt.initConfig({

  'dart-sass': {

    target: {

      options: {

        sourceMap: false

      },

      files: {

        'dest/css/style.css': 'src/scss/style.scss'

      }

    }

  }

});

```