Skip to content

Commit e4f8340

Browse files
authored
docs: update lightningcss default notes (#21907)
1 parent 9b7d150 commit e4f8340

File tree

2 files changed

+4
-10
lines changed

2 files changed

+4
-10
lines changed

docs/config/build-options.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -130,7 +130,7 @@ In this case, you need to set `build.cssTarget` to `chrome61` to prevent vite fr
130130
## build.cssMinify
131131

132132
- **Type:** `boolean | 'lightningcss' | 'esbuild'`
133-
- **Default:** the same as [`build.minify`](#build-minify) for client, `'lightningcss'` for SSR
133+
- **Default:** `'lightningcss'`, but `false` if [`build.minify`](#build-minify) is disabled for client build
134134

135135
This option allows users to override CSS minification specifically instead of defaulting to `build.minify`, so you can configure minification for JS and CSS separately. Vite uses [Lightning CSS](https://lightningcss.dev/minification.html) by default to minify CSS. It can be configured using [`css.lightningcss`](./shared-options.md#css-lightningcss). Set the option to `'esbuild'` to use esbuild instead.
136136

docs/guide/features.md

Lines changed: 3 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -353,17 +353,11 @@ Default and named imports from CSS files (e.g `import style from './foo.css'`) a
353353

354354
### Lightning CSS
355355

356-
Starting from Vite 4.4, there is experimental support for [Lightning CSS](https://lightningcss.dev/). You can opt into it by adding [`css.transformer: 'lightningcss'`](../config/shared-options.md#css-transformer) to your config file and install the optional [`lightningcss`](https://www.npmjs.com/package/lightningcss) dependency:
356+
Vite uses [Lightning CSS](https://lightningcss.dev/) to minify CSS in production builds by default. However, PostCSS is still used for other CSS processing.
357357

358-
```bash
359-
npm add -D lightningcss
360-
```
361-
362-
If enabled, CSS files will be processed by Lightning CSS instead of PostCSS. To configure it, you can pass Lightning CSS options to the [`css.lightningcss`](../config/shared-options.md#css-lightningcss) config option.
363-
364-
To configure CSS Modules, you'll use [`css.lightningcss.cssModules`](https://lightningcss.dev/css-modules.html) instead of [`css.modules`](../config/shared-options.md#css-modules) (which configures the way PostCSS handles CSS modules).
358+
There is experimental support for using Lightning CSS for CSS processing entirely. You can opt into it by adding [`css.transformer: 'lightningcss'`](../config/shared-options.md#css-transformer).
365359

366-
By default, Vite uses esbuild to minify CSS. Lightning CSS can also be used as the CSS minifier with [`build.cssMinify: 'lightningcss'`](../config/build-options.md#build-cssminify).
360+
To configure it, you can pass Lightning CSS options to the [`css.lightningcss`](../config/shared-options.md#css-lightningcss) config option. To configure CSS Modules, you should use [`css.lightningcss.cssModules`](https://lightningcss.dev/css-modules.html) instead of [`css.modules`](../config/shared-options.md#css-modules) (which configures the way PostCSS handles CSS modules).
367361

368362
## Static Assets
369363

0 commit comments

Comments
 (0)