/dart-sass-embedded

A wrapper for Dart Sass that implements the compiler side of the Embedded Sass protocol

Primary LanguageDartMIT LicenseMIT

This is no longer the repository for Embedded Dart Sass. The embedded compiler has been merged into the primary Dart Sass repository, and further releases will be included as part of Dart Sass itself. The embedded compiler can be accessed by running sass --embedded.

Embedded Dart Sass

This is a wrapper for Dart Sass that implements the compiler side of the Embedded Sass protocol. It's designed to be embedded in a host language, which then exposes an API for users to invoke Sass and define custom functions and importers.

Usage

  • dart-sass-embedded starts the compiler and listens on stdin.
  • dart-sass-embedded --version prints versionResponse with id = 0 in JSON and exits.

Development

To run the embedded compiler from source:

  • Run dart pub get.

  • Install buf.

  • Run dart run grinder protobuf.

From there, you can either run dart bin/dart_sass_embedded.dart directly or dart run grinder pkg-standalone-dev to build a compiled development executable.

Releases

Binary releases are available from the GitHub release page. We recommend that embedded hosts embed these release binaries in their packages, or use a post-install script to install a specific version of the embedded compiler to avoid version skew.

Disclaimer: this is not an official Google product.