dart-sass/README.md
Natalie Weizenbaum f50a3f0da3
Use buf instead of protoc to compile protobufs (#146)
This is more consistent with the embedded host, and avoids relying on
the seldom-maintaned arduino/setup-protoc GitHub action.
2023-02-08 17:30:05 -08:00

1.3 KiB

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.