underdot-sass

Compiles every SCSS stylesheet in an Underdot site to CSS with Sass.

Install

npm install underdot-sass

import type { Configuration } from 'underdot';
import { sass } from 'underdot-sass';

export default {
  plugins: [sass()],
} satisfies Configuration;

Compiling

• Every .scss file compiles to a .css file at the same path, in Sass's expanded style with no source map.
• A file whose name starts with an underscore is a partial, and compiles to nothing.
• An import resolves against the stylesheet's own directory, then against the source root, so a partial kept in _sass/ is @use '_sass/mixins' from any depth.
• An import outside the source root fails the build.
• Every file a stylesheet imports is tracked, so underdot dev recompiles the stylesheet when one changes.
• @warn, @debug, and Sass's deprecations print, and the build continues.

To minify or prefix the compiled CSS, list underdot-postcss after this plugin.

Options

The plugin takes no options.

q-docs/specs/sass.md holds every rule the plugin commits to.