Set up Master CSS in Blazor

Guide to setting up Master CSS in your Blazor 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://blazor.se.beta.css.master.co

Quick start

Clone the example

Copy-paste the following commands to quickly start using the blazor.se.beta.css.master.co.

You can skip all installation steps.

npx degit master-co/css/examples/blazor-with-static-extraction my-project
cd my-project
npm install @master/css-extractor.blazor@beta
npm install
npm run dev

Installation

Create a project

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

npm create blazor@latest project -- --template vanilla-ts
cd project
npm install

Install Master CSS Extractor

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

npm install @master/css-extractor.blazor@beta

Initialize configuration file

Run npx mcss init to create a configuration file master.css.ts.

npx mcss init

Set up CSS extractor

Create a blazor.config.ts file
Add a CSSExtractorPlugin to the blazor plugins

import { defineConfig } from 'blazor'
import { CSSExtractorPlugin } from '@master/css-extractor.blazor'
 
export default defineConfig({
    plugins: [
        CSSExtractorPlugin()
    ]
})

Import virtual CSS module

Import the virtual CSS module .virtual:master.css into the main.ts.

…
import '.virtual:master.css';

Launch server

Run the Blazor development server.

npm run dev -- --open

Hello world!

Now style your first element using Master CSS syntax!

<!DOCTYPE html>
<html lang="en" style="display: none">
    …
    <body>
        <h1 class="font:40 font:heavy italic m:50 text:center">Hello World</h1>
        …
    </body>
</html>

Open your browser to watch the changes.

localhost:5173