Installation

Set up Master CSS in React

React

Guide to setting up Master CSS in your React project.

Master CSS Runtime Rendering observes changes in DOM class names at browser runtime, generates corresponding CSS rules, and injects them into the running style sheet.

Fixed style cost

All features work out of the box with ~17KB transfer cost

Fully automatic

Capture any program-generated class names

CSS lifecycle

Generated on-demand and frees memory when not in use


A full-stack framework, such as Next.js, Remix, etc., is recommended for better application performance and experience.


Quick start

Clone the example

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

You can skip all installation steps.

npm create @master/css@rc <project> --example reactcd <project>npm run dev

Installation

Create a project

If you don't have a React project, create one first. It's recommended to refer to Start a New React Project.

npm create vite@latest <project> -- --template react-tscd <project>

Initialize configuration file

Run the command to create a configuration file master.css.ts.

npm create @master/css@rc

Install Master CSS

Install Master CSS into your project via package managers.

npm i @master/css.react@rc

Set up CSS runtime engine

  • Import your custom configuration master.css.ts
  • Initialize the runtime engine using CSSRuntimeProvider
  • Add display: none in <html> to avoid FOUC
import React from 'react'import ReactDOM from 'react-dom/client'import App from './App'import './index.css'import CSSRuntimeProvider from '@master/css.react' import config from '../master.css' ReactDOM.createRoot(document.getElementById('root') as HTMLElement).render(    <React.StrictMode>        <CSSRuntimeProvider config={config}>            <App />        </CSSRuntimeProvider>    </React.StrictMode>,)

Prevent flash of unstyled content

Add <html hidden> to avoid FOUC caused by the runtime engine not yet injecting CSS rules.

<!DOCTYPE html><html lang="en" hidden>

Launch server

Run the Vite development server.

npm run dev -- --open

Hello world!

Now style your first element using Master CSS syntax!

export default function App() {    return (        <h1 className="font:40 font:heavy italic m:12x text:center">Hello World</h1>    )}

Open your browser to watch the changes.

localhost:5173

Hello World

© Aoyue Design LLC.