Skip to content

dart-league/sass_builder

Repository files navigation

Build status

package:sass_builder transpiles Sass files using the build package and the Dart implementation of Sass.

Usage

1. Add build_runner and sass_builder as dev dependencies in your pubspec.yaml file:

dart pub add dev:build_runner dev:sass_builder

If you want to use any packages that provide source sass files, add them as normal pub dependencies. For example, if you want to use styles from package:bootstrap_sass:

dart pub add bootstrap_sass

2. Create web/main.scss containing the following code:

@use "sub";
@use "package:bootstrap_sass/scss/variables" as bootstrap;

.a {
  color: blue;
}

.c {
  color: bootstrap.$body-color;
}

3. Create web/_sub.scss containing the following code:

.b {
  color: red;
}

4. Create web/index.html containing the following code:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Sample</title>
    <link rel="stylesheet" href="main.css">
</head>
<body>
<div class="a">Some Text</div>
<div class="b">Some Text</div>
<div class="c">Some Text</div>
</body>
</html>

5. Run dart run build_runner serve and then go to localhost:8080 with a browser and check if the file web/main.css was generated containing:

.b {
  color: red;
}

.a {
  color: blue;
}

.c {
  color: #373a3c;
}

Builder Options

To configure options for the builder see the build_config README.

  • outputStyle: Supports expanded or compressed. Defaults to expanded in dev mode, and compressed in release mode.
  • sourceMaps: Whether to emit source maps for compiled CSS. Defaults to true in development mode and to false in release mode.

Example that compresses output in dev mode:

targets:
  $default:
    builders:
      sass_builder:
        options:
          outputStyle: compressed

About

Transpile sass files using the "build" package.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 14