Registry / devops / rollup-plugin-sass-modules

rollup-plugin-sass-modules

JSON →
library1.4.0jsnpmunverified

A Rollup plugin that imports and compiles SASS/SCSS files as modules, supporting sourcemaps and extraction of CSS files. Version 1.4.0 is the latest stable release. It integrates with dart-sass and allows import from `node_modules`. Key differentiator: exports the dependency tree to Rollup and supports post-processing via a `processor` function. Ideal for projects using Rollup as a bundler who want to use Sass with CSS modules or extracted CSS.

npm install rollup-plugin-sass-modules
INSTALL
IMPORT
SIG · ROLLUP-PLUGIN-SASS
R
rollup-plugin-sass-modules
devopsjavascriptv1.4.0
Install
Import
Disk
Pass rate
0/ 6
Env Coverage0 / 6
glibc
1822
musl
1822
Install & Compatibility
Where this runs
tested against v? · npm install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
node 18223 runs
build_error
glibc
node 18223 runs
build_error
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

sassModules
import sassModules from 'rollup-plugin-sass-modules'
const sassModules = require('rollup-plugin-sass-modules')
Package supports ESM; default import.
sassModules
import { sassModules } from 'rollup-plugin-sass-modules'
import sassModules from 'rollup-plugin-sass-modules'
Use named export if preferred, but default export is the primary way.
sassModules
const sassModules = require('rollup-plugin-sass-modules').default
const sassModules = require('rollup-plugin-sass-modules')
CommonJS users must access `.default` due to ESM-first design.

Configures Rollup to compile Sass files as modules, enabling imports from JavaScript and generating sourcemaps.

import sassModules from 'rollup-plugin-sass-modules'; import { babel } from '@rollup/plugin-babel'; import resolve from '@rollup/plugin-node-resolve'; export default { input: 'src/index.js', output: { file: 'dist/bundle.js', format: 'iife', }, plugins: [ resolve(), sassModules({ include: ['**/*.scss', '**/*.sass'], exclude: ['node_modules'], options: { outputStyle: 'compressed', sourceMap: true, }, }), babel({ babelHelpers: 'bundled' }), ], };
Debug
Known issues
breakingVersion 1.x requires peer dependency of Rollup >=1.0.0; older Rollup versions (0.x) break.
fix
Upgrade to Rollup >= 1.0.0.
affects: >=1.0.0
deprecatedThe `processor` option accepts a function returning a Promise; using synchronous processor is deprecated.
fix
Ensure processor returns a Promise resolving to { code, map }.
affects: >=1.0.0
gotchaBy default, the plugin does not extract CSS unless `options.outFile` is provided. Without it, CSS is emitted as a module.
fix
Set `options.outFile` to extract CSS to a file, or use `emitCss: true` option (if supported).
affects: >=1.0.0
gotchaImporting .sass or .scss files requires the file extension in the import statement.
fix
Use full path with extension, e.g., `import './styles.scss'`.
affects: >=1.0.0
gotchaThe plugin uses dart-sass (the `sass` package) internally; ensure it is installed as a dev dependency.
fix
Run `npm install sass --save-dev`.
affects: >=1.0.0
Errors
Common errors & fixes
Error: Cannot find module 'rollup-plugin-sass-modules'
Package not installed or missing from package.json devDependencies.
fix
Run `npm install rollup-plugin-sass-modules --save-dev`.
TypeError: sassModules is not a function
CommonJS require() without accessing .default; or using named import when default is expected.
fix
Use `const sassModules = require('rollup-plugin-sass-modules').default` for CommonJS, or use ESM import.
Error: The 'sass' package is required. Please install it: npm install sass --save-dev
dart-sass peer dependency not installed.
fix
Install the `sass` package as devDependency.
Error: You must specify an 'outFile' option to extract CSS.
CSS extraction attempted without providing outFile in options.
fix
Add `options: { outFile: 'dist/styles.css' }` to plugin config.
Upgrade
Version history
1.4.0latest on npm
Audit
Dependencies
rollupoptionalpeer dependency; plugin is designed to work with Rollup
Agent activity
6 hits · last 30 days
node
6
Resources
rollup-plugin-sass-modules — npm install rollup-plugin-sass-modules · libregistry