Skip to main
Link
A close up of the hands of a person handing a package
to another person.

Sass Package Importer (Request for Comments)

A new proposal for importing from NPM packages in Sass

UI libraries like Vuetify and Bootstrap make it easy to extend their themes by providing Sass source files with their NPM packages. Now, Sass is requesting feedback on a simpler way to import those libraries into your Sass styles with e.g. @use "pkg:bootstrap".

Read the summary & proposal »

Many UI libraries provide Sass source code alongside JavaScript in a Node.js package, so that users can customize package styles or themes. There hasn’t been an easy way to specify that a file to be imported is from an installed package, so build tools have provided a variety of ways to import from a package and define where packages are installed.

This has meant that switching build tools might result in unexpected gotchas, or that many more potential paths need to be checked to see if a file exists at that location.

The Node Package Importer will allow users to specify with a pkg: URL that an import is in a Node.js package installed alongside their source code.

@use "pkg:vuetify";

When a Node Package Importer is added to the importers for a compilation, this directs Sass to find a Node.js module called vuetify, and import the default Sass file defined by the vuetify package.

I’m excited by what this provides library authors – this makes it much more straightforward to expose Sass source files, and to expect that users can import those files, regardless of their setup.

It also allows library authors to take advantage of package entry points, so they can specify exactly which files are exposed, and at what paths.

For instance, an author could expose the file at ./src/sass/themes/_dark.scss in a way that would allow someone using the package to simply write @use "pkg:my_package/dark".

This also uses conditional exports, so package authors can specify a Sass default entry point that is different from their JavaScript entry point.

I look forward to this feature shipping, and making integration easier for both package authors and users.

  1. Sass logo in black
on top of bright oklch color gradient
    Link post type

    Sass Color Spaces & Wide Gamut Colors

    Inspect and manipulate the new CSS color formats in Sass!

    CSS has a range of new color functions that support wider color gamuts (like display-p3) and perceptually uniform color adjustments (like oklch). Sass now provides additional tools for working with these new color formats, and converting between them.

    see all Link posts
  2. FD logo repeated on a red background
    Link post type

    5 Questions for Miriam Suzanne

    I talked with Jens Oliver Meiert over at Frontend Dogma about our work here at OddBird, what’s happening in the CSS Working Group, and advice for getting started in frontend development.

    see all Link posts
  3. 12 Days of Web
    Link post type

    CSS @scope

    Keep selector conflicts to a minimum

    The new @scope rule is here! It’s a better way to keep our component styles contained – without relying on third-party tools or extreme naming conventions.

    see all Link posts