Registry / rollup-plugin-css-module

rollup-plugin-css-module

library0.0.25jsnpmunverified

A Rollup plugin for handling CSS Modules with PostCSS. Current stable version is 0.0.25, released with limited update cadence (sporadic). It provides basic CSS Modules support in Rollup bundles by leveraging PostCSS for transformation. Compared to alternatives like rollup-plugin-postcss, this plugin is lighter but less maintained, with fewer configuration options and no built-in CSS extraction. Suitable for simple projects that need CSS Modules without extra features.

npm install rollup-plugin-css-module

github ↗package ↗

INSTALL

IMPORT

SIG · ROLLUP-PLUGIN-CSS-

rollup-plugin-css-module

javascriptv0.0.25

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

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 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

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

cssModule

✓ import cssModule from 'rollup-plugin-css-module'

✗ const cssModule = require('rollup-plugin-css-module')

Plugin uses default export. CJS require works but ESM preferred.

default export

✓ import cssModule from 'rollup-plugin-css-module'

✗ import { cssModule } from 'rollup-plugin-css-module'

Named import does not exist; use default import.

Plugin (with config)

✓ cssModule({ insert: true })

✗ cssModule.insert({ insert: true })

Plugin is a function, not an object with methods.

Shows basic Rollup config with css-module plugin, using include/exclude patterns and insert mode.

import cssModule from 'rollup-plugin-css-module'; import resolve from '@rollup/plugin-node-resolve'; import commonjs from '@rollup/plugin-commonjs'; export default { input: 'src/index.js', output: { dir: 'dist', format: 'esm' }, plugins: [ cssModule({ include: '**/*.css', exclude: '**/global.css', insert: true }), resolve(), commonjs() ] };

Debug

Known issues

deprecatedThe `insert` option defaults to true but may be deprecated in future; prefer explicit setting.

fix

Set insert: true explicitly or inline CSS via other means.

affects: >=0.0.1

gotchaPlugin does not automatically include/exclude files; must specify `include` and `exclude` patterns.

fix

Add include/exclude patterns matching your CSS file names.

affects: >=0.0.1

gotchaWhen using together with rollup-plugin-postcss, order may cause conflicts. Only one CSS plugin should handle modules.

fix

Disable CSS modules in rollup-plugin-postcss if both are used.

affects: >=0.0.1

Errors

Common errors & fixes

Error: Cannot find module 'postcss'

PostCSS is not installed, but it's a peer dependency.

fix

npm install postcss --save-dev

TypeError: cssModule is not a function

Using named import instead of default import.

fix

Use `import cssModule from 'rollup-plugin-css-module'`

Error: Unexpected behavior with CSS modules (class names not transformed)

Plugin not included or not matching the CSS files.

fix

Ensure plugin is in plugins array and include pattern matches your CSS.

Upgrade

Version history

0.0.25latest on npm

Audit

Dependencies

postcssoptionalRequired peer dependency for CSS transformation; not automatically installed.

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/paul-veevers/rollup-plugin-css-module ↗

packagehttps://www.npmjs.com/package/rollup-plugin-css-module ↗