Set up Master CSS in Webpack

Guide to setting up Master CSS in your Webpack project.

Master CSS Static Extraction integrates build tools to scan project source code, extract class names, generate CSS rules, and write them into a virtual CSS module.

Zero runtime

Generate virtual CSS modules at build time

Semi-dynamic

Scan all source code to extract class names

Cross-page caching

Download the CSS bundle for all pages at once

https://webpack.se.rc.css.master.co

Quick start

Clone the example

Copy-paste the commands to quickly start using the https://webpack.se.rc.css.master.co example.

You can skip all installation steps.

npm create @master/css@rc project --example webpack-with-static-extraction
cd project
npm run dev

Installation

Create a project

If you don't have a Webpack project, create one first. It's recommended to refer to Getting Started - Webpack

mkdir project
cd project
npm init -y
npm install webpack webpack-cli webpack-dev-server html-webpack-plugin css-loader style-loader ts-loader --save-dev

Initialize configuration file

Run npm create @master/css@rc to create a configuration file master.css.ts.

npm create @master/css@rc

Install Master CSS Extractor

Install the Master CSS extractor into your project via package managers.

npm install @master/css-extractor.webpack@rc

Create a Webpack config file

Create and configure the webpack.config.js file.

const path = require('path')
const HtmlWebpackPlugin = require('html-webpack-plugin')
const CSSExtractorPlugin = require('@master/css-extractor.webpack')
 
module.exports = {
    entry: './src/index.js',
    output: {
        filename: 'bundle.js',
        path: path.join(__dirname, 'dist')
    },
    plugins: [
        new HtmlWebpackPlugin({
            template: path.join(__dirname, 'src/index.html')
        }),
        new CSSExtractorPlugin({ sources: ['./src/index.html'] })
    ],
    devServer: {
        watchFiles: ['src/**/*']
    },
    module: {
        rules: [
            { test: /\.css$/, use: ['style-loader', 'css-loader'] }
        ]
    }
}

Configure a HTML file

Create and configure the src/index.html file.

<!doctype html>
<html lang="en">
<head>
    <meta charset="utf-8" />
</head>
<body>
    <h1>Hello World</h1>
</body>
</html>

Import virtual CSS module

Import the virtual CSS module .virtual/master.css into the src/index.js.

import '.virtual/master.css';

Add scripts to `package.json`

Add start and build scripts to standardize the development process.

{
    "scripts": {
        "dev": "webpack serve --mode development",
        "build": "webpack --mode production"
    }
}

Launch server

Run the development server.

npm run dev

Hello world!

Now style your first element using Master CSS syntax!

<!doctype html>
<html lang="en">
<head>
    <meta charset="utf-8" />
    <script src="./index.js"></script>
</head>
<body>
    <h1 class="font:40 font:heavy italic m:12x text:center">Hello World</h1>
</body>
</html>

Open your browser to watch the changes.

localhost:3000