Registry / devops / rollup-plugin-lightningcss

rollup-plugin-lightningcss

library1.0.0jsnpmunverified

A Rollup plugin that uses Parcel's LightningCSS for CSS transformation and minification. Version 1.0.0, released recently. It integrates LightningCSS into Rollup's build pipeline, supporting CSS minification and source map generation via the `generateBundle` hook. Compared to other CSS plugins (e.g., rollup-plugin-postcss), it leverages LightningCSS's native performance and modern CSS features. Currently, CSS files are output at the same level as the entrypoint; output destination is not configurable.

devops

npm install rollup-plugin-lightningcss

github ↗package ↗

INSTALL

IMPORT

SIG · ROLLUP-PLUGIN-LIGH

rollup-plugin-lightningcss

devopsjavascriptv1.0.0

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.

default

✓ import lightningcss from 'rollup-plugin-lightningcss'

✗ const lightningcss = require('rollup-plugin-lightningcss')

The plugin is ESM-only; CommonJS require is not supported.

lightningcss

✓ import lightningcss from 'rollup-plugin-lightningcss'

✗ import { lightningcss } from 'rollup-plugin-lightningcss'

Default export only; named export does not exist.

type Options

✓ import type { Options } from 'rollup-plugin-lightningcss'

Type import for TypeScript users; Options is exported as a named type.

Minifies CSS files using LightningCSS with Rollup, enabling source maps and specifying browserslist.

import lightningcss from 'rollup-plugin-lightningcss'; export default { input: 'src/index.js', output: { dir: 'dist', format: 'esm', sourcemap: true }, plugins: [ lightningcss({ minify: true, sourceMap: true, browserslist: '>= 0.5%' }) ] };

Debug

Known issues

breakingCSS output destination is not configurable; all files placed at the same level.

fix

Use Rollup's assetFileNames option to control output paths if needed, or handle file movement post-build.

affects: >=1.0.0

gotchaPlugin only transforms separate CSS files; CSS imported in JS via CSS modules not supported.

fix

Use additional plugins (e.g., @rollup/plugin-styles) if you need CSS module support.

affects: >=1.0.0

gotchaSource maps only generated if sourceMap option is explicitly set to true.

fix

Set sourceMap: true in plugin options to enable source maps.

affects: >=1.0.0

Errors

Common errors & fixes

Error [ERR_REQUIRE_ESM]: require() of ES Module not supported

Using require() to load an ESM-only package.

fix

Use import syntax or set type: 'module' in package.json.

TypeError: lightningcss is not a function

Importing the plugin as a named export instead of default.

fix

Use default import: import lightningcss from 'rollup-plugin-lightningcss'.

[!] (plugin lightningcss) Error: ...

Invalid options passed to the plugin (e.g., unsupported LightningCSS options).

fix

Review LightningCSS documentation and ensure options match the expected configuration.

Upgrade

Version history

1.0.0latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/thearchitector/rollup-plugin-lightningcss ↗

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