README

css-module-override-webpack-plugin

This plugin extends mini-css-extract-plugin to work with module-override-loader and module-override-webpack-plugin.

It loads CSS module overrides according to a file pattern and creates additional stylesheet files.

Install

npm install css-module-override-webpack-plugin module-override-loader --save-dev

Usage

Example

Let's say you imported file base.css and you have base.batman.css and base.superman.css in same location.

const CssModuleOverrideWebpackPlugin = require('css-module-override-webpack-plugin');

module.exports = {
    entry: {
        main: 'src/app.js'
    },
    output: {
        path: 'dist/'
    },
    module: {
        rules: [
            {
                test: /\.css$/,
                use: [
                    {
                        loader: 'module-override-loader',
                        options: {
                            overrides: ['batman', 'superman'],
                            pattern: '[name].[override].[ext]'
                        }
                  },
                  "css-loader"
                ]
            }
        ]
    },
    plugins: [
        new CssModuleOverrideWebpackPlugin({
            filename: "[name].css",
            overrides: ['batman', 'superman'],
            standalone: true,
            standaloneOverridesOutputPath: 'overrides/[name].[override].css'
        })
    ]
}

Then you will end up with three stylesheet files dist/main.css, dist/main.batman.css and main.superman.css.

Usage with module-override-webpack-plugin

If you are using module-override-webpack-plugin for JS overrides you have to turn standalone mode off. Then CSS overrides will be saved relative to JS override output.

const ModuleOverrideWebpackPlugin = require('module-override-webpack-plugin');
const CssModuleOverrideWebpackPlugin = require('css-module-override-webpack-plugin');

module.exports = {
    entry: {
        main: 'src/app.js'
    },
    output: {
        path: 'dist/',
        filename: '[name]/script.js',
    },
    module: {
        rules: [
            {
                test: /\.js$/,
                use: [
                    {
                        loader: 'module-override-loader',
                        options: {
                            overrides: ['batman', 'superman'],
                            pattern: '[name].[override].[ext]'
                        }
                    },
                    'babel-loader'
                ]
            },
            {
                test: /\.css$/,
                use: [
                    {
                        loader: 'module-override-loader',
                        options: {
                            overrides: ['batman', 'superman'],
                            pattern: '[name].[override].[ext]'
                        }
                    },
                    "css-loader"
                ]
            }
        ]
    },
    plugins: [
        new ModuleOverrideWebpackPlugin({
            overrides: ['batman', 'superman'],
            outputPath: '[name]/overrides/[override]'
        }),
        new CssModuleOverrideWebpackPlugin({
            filename: "[name].css",
            overrides: ['batman', 'superman'],
            standalone: false
        })
    ]
}

Then you end up with this result:

dist/
-- main/
  -- script.js
  -- main.css
  -- overrides/
    -- batman/
      -- script.js
      -- main.css
    -- superman/
      -- script.js
      -- main.css

Options

Option	Default	Description
overrides	`undefined`	Array of strings. Overrides to process
keepOriginals	`false`	If set to false, resulting bundle will contain only overridden modules
standalone	`false`	Set to true to use without `module-override-webpack-plugin`
standaloneOverridesOutputPath	`undefined`	Path for the bundles with overrides

Debug

You can use debug library with namespace css-module-override-webpack-plugin. debug is optional dependency. You have to install it yourself if you want to use it.

Usage no npm install needed!