Lightning CSS

Transform and minify your CSS files with Lightning CSS.

Options See on deno.land

extensions string[]

The list of extensions this plugin applies to

Default:
[ ".css" ]
includes string boolean

Custom includes path

Default:
site.options.includes
options object

Options passed to parcel_css

Default:
{
  minify: true,
  drafts: { customMedia: true },
  targets: {
    android: 6422528,
    chrome: 6422528,
    edge: 6422528,
    firefox: 6356992,
    ios_saf: 983040,
    safari: 983040,
    opera: 5439488,
    samsung: 1048576
  }
}

Description

The lightningcss plugin bundles your CSS files using the Lightning CSS processor (previously known as Parcel CSS).

Installation

Import this plugin in your _config.ts file to use it:

import lume from "lume/mod.ts";
import lightningCss from "lume/plugins/lightningcss.ts";

const site = lume();

site.use(lightningCss(/* Options */));

export default site;

Configuration

This plugin accepts a configuration object. The available options are:

  • extensions: Array with the extensions of the files that this plugin will load. By default is [".css"]. instead of replacing them.
  • options: An object with the options for lightning-css.
  • includes: The directory to search for the @imported files. By default it is "_includes". Set false to disable it.

Example with the default configuration:

import lume from "lume/mod.ts";
import lightningCss, { version } from "lume/plugins/lightningcss.ts";

const site = lume();

site.use(lightningCss({
  extensions: [".css"],
  includes: "_includes",
  options: {
    minify: true,
    drafts: {
      nesting: true,
      customMedia: true,
    },
    targets: {
      android: version(98),
      chrome: version(98),
      edge: version(98),
      firefox: version(97),
      ios_saf: version(15),
      safari: version(15),
      opera: version(83),
      samsung: version(16),
    },
  },
}));

export default site;

Tip

The version() function is provided to convert a semver version to single 24-bit number as used by lightningcss. More info