https://github.com/unplugin/unplugin-lightningcss
Lightning CSS integration for Vite, Rollup, esbuild, Webpack, Vue CLI, and more.
https://github.com/unplugin/unplugin-lightningcss
Last synced: 20 days ago
JSON representation
Lightning CSS integration for Vite, Rollup, esbuild, Webpack, Vue CLI, and more.
- Host: GitHub
- URL: https://github.com/unplugin/unplugin-lightningcss
- Owner: unplugin
- License: mit
- Created: 2023-08-12T15:23:41.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-01-18T10:03:27.000Z (25 days ago)
- Last Synced: 2026-01-18T17:42:57.169Z (24 days ago)
- Language: TypeScript
- Homepage:
- Size: 486 KB
- Stars: 29
- Watchers: 1
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# unplugin-lightningcss
[![npm version][npm-version-src]][npm-version-href]
[![npm downloads][npm-downloads-src]][npm-downloads-href]
[![JSR][jsr-src]][jsr-href]
[![Unit Test][unit-test-src]][unit-test-href]
Lightning CSS integration for Vite, Rollup, esbuild, Webpack, Vue CLI, and more.
## Installation
```bash
npm i -D unplugin-lightningcss
```
Vite
```ts
// vite.config.ts
import LightningCSS from 'unplugin-lightningcss/vite'
export default defineConfig({
plugins: [LightningCSS()],
})
```
Rollup
Since Rollup does not support CSS out of the box, you need to use a CSS plugin like [`rollup-plugin-css-only`](https://github.com/thgh/rollup-plugin-css-only).
```ts
// rollup.config.js
import css from 'rollup-plugin-css-only'
import LightningCSS from 'unplugin-lightningcss/rollup'
export default {
plugins: [LightningCSS(), css()],
}
```
esbuild
```ts
// esbuild.config.js
import { build } from 'esbuild'
build({
plugins: [require('unplugin-lightningcss/esbuild')()],
})
```
Webpack
```ts
// webpack.config.js
module.exports = {
/* ... */
plugins: [require('unplugin-lightningcss/webpack')()],
}
```
## Options
```ts
import { Features } from 'lightningcss'
export default {
plugins: [
LightningCSS({
options: {
include: Features.Nesting,
},
/**
* Whether to export the transformed CSS as a default string export.
* @default false
*/
asString: false,
}),
],
}
```
## Sponsors
## License
[MIT](./LICENSE) License © 2023-PRESENT [Kevin Deng](https://github.com/sxzz)
[npm-version-src]: https://img.shields.io/npm/v/unplugin-lightningcss.svg
[npm-version-href]: https://npmjs.com/package/unplugin-lightningcss
[npm-downloads-src]: https://img.shields.io/npm/dm/unplugin-lightningcss
[npm-downloads-href]: https://www.npmcharts.com/compare/unplugin-lightningcss?interval=30
[jsr-src]: https://jsr.io/badges/@unplugin/lightningcss
[jsr-href]: https://jsr.io/@unplugin/lightningcss
[unit-test-src]: https://github.com/unplugin/unplugin-lightningcss/actions/workflows/unit-test.yml/badge.svg
[unit-test-href]: https://github.com/unplugin/unplugin-lightningcss/actions/workflows/unit-test.yml