babel-plugin-template-css-demitasse

☕ Demitasse Babel Plugin

This Babel plugin converts CSS code embedded within a template literal to a compact format that Demitasse can use to produce CSS bindings. Simply tag the template literal with a leading /* css */ comment to activate the plugin.

Use this plugin in your production build to remove unused CSS code (e.g. large declaration blocks) since Demitasse only needs the class names and IDs to produce CSS bindings.

Note This is an aggressive optimization and assumes you are following our recommended approach of build-time CSS extraction. For more information, see our guides and examples.

Example

Input

const css = /*css*/`
  .container {
    height: 100%;
  }

  #header_nav {
    width: 100%;
  }
`;

Output

const css = /*css*/`/*extracted*/ .container #header_nav`;

Configuration

The plugin doesn't require any configuration in itself. Your .babelrc file can be as simple as this:

.babelrc

{ "plugins": ["babel-plugin-template-css-demitasse"] }

Due to Babel's first-to-last plugin ordering, this plugin should be placed at or near the beginning of the list of plugins so that it runs before template literals are transformed by another plugin.

See also

For a less aggressive optimization, see babel-plugin-template-css-minifier. This plugin simply minifies the CSS, otherwise leaving declaration blocks, media queries, and other CSS statements intact. This may be useful in some scenarios, such as:

• Needing a css export to remain useful at runtime for some purpose other than generating CSS bindings
• Adding component CSS to the document explicitly at runtime