README

esm-loader-css

Node.js ESModule Loader for CSS and related preprocessor stylesheets.

Supported stylesheet filename extensions: .css .less .pcss .postcss .sass .scss .sss .styl

Warning! Using experimental Node.js features and flags, API will likely change. This may be helpful for development and testing, but should not be used in production.

Usage

npm install --save-dev esm-loader-css

We want to import a .css file with Node.js:

/* index.css */
body {
  color: blue;
}

// index.js
import styles from './index.css'

console.dir(styles)
// "body { color: blue }"

Standalone

NODE_OPTIONS="--experimental-loader esm-loader-css" node index.js

Chainable

This loader can be configured, and chained with other loaders, using node-esm-loader. This should be your only loader handling stylesheet files.

npm install --save-dev node-esm-loader

// .loaderrc.js
export default {
  loaders: ['esm-loader-css'],
}

NODE_OPTIONS="--experimental-loader node-esm-loader" node index.js

Option: Debug

// .loaderrc.js
export default {
  loaders: [
    {
      loader: 'esm-loader-css',
      options: {
        debug: true,
      },
    },
  ],
}

Future

Allow customization of valid css filename extensions list via .loaderrc config file?

License

MIT

Usage no npm install needed!