# @master/css-server

> Server-side HTML renderer for Master CSS

Latest version **2.1.2** (published 2026-11-10) · MIT license · 0 weekly downloads

## Install

```sh
npm install @master/css-server
pnpm add @master/css-server
yarn add @master/css-server
bun add @master/css-server
```

## Health

**Score 55/100 (C)** — status: active.

Positive: no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 2.1.2 |
| Published | 2026-11-10 |
| First published | 2023-10-30 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1953 |
| Author | Aoyue Design LLC. |
| Maintainers | 1aron, benseage0 |
| Keywords | server, static, html, markup, dom, css, mastercss |

## Links

- npm: https://www.npmjs.com/package/@master/css-server
- Repository: https://github.com/master-co/css
- Homepage: https://css.master.co
- Issues: https://github.com/master-co/css/issues
- npm.io page: https://npm.io/package/@master/css-server

## Alternatives

- [@tsparticles/shape-image](https://npm.io/package/@tsparticles/shape-image.md) — 303.7K weekly downloads
- [@tsparticles/shape-line](https://npm.io/package/@tsparticles/shape-line.md) — 233.7K weekly downloads
- [stringify-attributes](https://npm.io/package/stringify-attributes.md) — 58.6K weekly downloads
- [mobile-drag-drop](https://npm.io/package/mobile-drag-drop.md) — 46.3K weekly downloads
- [@comunica/actor-rdf-parse-html](https://npm.io/package/@comunica/actor-rdf-parse-html.md) — 29.2K weekly downloads

## Recent versions

- 2.1.2 (latest) — 2026-11-10
- 2.1.3 (candidate-2.1.3) — 2026-11-11
- 2.1.1 (candidate-2.1.1) — 2026-11-09
- 2.1.0 (candidate-2.1.0) — 2026-11-09
- 2.0.4 (candidate-2.0.4) — 2026-11-08
- 2.0.3 (candidate-2.0.3) — 2026-11-07
- 2.0.2 (candidate-2.0.2) — 2026-11-07
- 2.0.1 (candidate-2.0.1) — 2026-11-07
- 2.0.0 (candidate-2.0.0) — 2026-11-05
- 0.0.0-site.1793661807.g69c9aebcf628 (site) — 2026-11-02
- 2.0.0-rc.88 (rc) — 2026-07-24
- 2.0.0-beta.215 (beta) — 2024-01-08
- 0.0.0-site.1793659883.g69c9aebcf628 — 2026-11-02
- 2.0.0-rc.87 — 2026-07-20
- 2.0.0-rc.86 — 2026-07-20
- … 109 more at https://npm.io/package/@master/css-server/versions

## README

<br>
<div align="center">

<p align="center">
  <a href="https://css.master.co">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://user-images.githubusercontent.com/33840671/201701649-3bb7d698-abec-4d5f-ac30-ccc4d7bafcd4.svg">
      <source media="(prefers-color-scheme: light)" srcset="https://user-images.githubusercontent.com/33840671/201703010-77bf2373-9899-40cc-98f5-30cf9b546941.svg">
      <img alt="Master CSS" src="https://user-images.githubusercontent.com/33840671/201703010-77bf2373-9899-40cc-98f5-30cf9b546941.svg" width="100%">
    </picture>
  </a>
</p>
<p align="center">Server-side HTML renderer for Master CSS</p>

<p align="center">
  <a aria-label="GitHub release (latest by date including pre-releases)" href="https://github.com/master-co/css/releases">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/github/v/release/master-co/css?include_prereleases&color=212022&label=&style=for-the-badge&logo=github&logoColor=fff">
      <source media="(prefers-color-scheme: light)" srcset="https://img.shields.io/github/v/release/master-co/css?include_prereleases&color=f6f7f8&label=&style=for-the-badge&logo=github&logoColor=%23000">
      <img alt="GitHub release" src="https://img.shields.io/github/v/release/master-co/css?include_prereleases&color=f6f7f8&label=&style=for-the-badge&logo=github">
    </picture>
  </a>
  <a aria-label="NPM Package" href="https://www.npmjs.com/package/@master/css-server">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/npm/dm/@master/css-server?color=212022&label=%20&logo=npm&style=for-the-badge">
      <source media="(prefers-color-scheme: light)" srcset="https://img.shields.io/npm/dm/@master/css-server?color=f6f7f8&label=%20&logo=npm&style=for-the-badge">
      <img alt="NPM package ( download / month )" src="https://img.shields.io/npm/dm/@master/css-server?color=f6f7f8&label=%20&logo=npm&style=for-the-badge">
    </picture>
  </a>
  <a aria-label="Follow @mastercorg" href="https://twitter.com/mastercorg">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/static/v1?label=%20&message=twitter&color=212022&logo=twitter&style=for-the-badge">
      <source media="(prefers-color-scheme: light)" srcset="https://img.shields.io/static/v1?label=%20&message=twitter&color=f6f7f8&logo=twitter&style=for-the-badge">
      <img alt="Follow @mastercorg" src="https://img.shields.io/static/v1?label=%20&message=twitter&color=f6f7f8&logo=twitter&style=for-the-badge">
    </picture>
  </a>
  <a aria-label="GitHub Actions" href="https://github.com/master-co/css/actions/workflows/release.yml">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://img.shields.io/github/actions/workflow/status/master-co/css/release.yml?branch=main&label=%20&color=212022&logo=githubactions&style=for-the-badge">
      <source media="(prefers-color-scheme: light)" srcset="https://img.shields.io/github/actions/workflow/status/master-co/css/release.yml?branch=main&label=%20&color=f6f7f8&logo=githubactions&style=for-the-badge&logoColor=%23000">
      <img alt="GitHub release workflow" src="https://img.shields.io/github/actions/workflow/status/master-co/css/release.yml?branch=main&label=%20&color=f6f7f8&logo=githubactions&style=for-the-badge&logoColor=%23000">
    </picture>
  </a>
</p>

</div>

## Installation

```bash
npm install @master/css-server
```

`@master/css-server` owns HTML parsing and style/hydration injection. Every entry
requires an explicit `MasterCSSManifest`; class-only rendering belongs to
`@master/css/node`.

Use this package for the HTML step of the [`prerender` and `progressive` rendering modes](https://css.master.co/guide/rendering-modes). Both generate CSS from the rendered page. For `prerender`, pass `hydrationManifest: false`. For `progressive`, deliver the hydration manifest so the browser runtime can reuse the page CSS and generate rules for later classes.

## API

### `renderHTML()`

The one-shot API owns and releases its render session. Its result is an immutable
snapshot and does not expose DOM nodes, bindings, or disposable CSS state.

```ts
import { renderHTML } from '@master/css-server'

const result = renderHTML('<div class="text-center"></div>', {
  manifest,
  hydrationManifest: 'inline'
})

console.log(result.html)
console.log(result.cssText)
console.log(result.classNames)
console.log(result.diagnostics)
```

### `createServerRenderer()`

Create a manifest-scoped renderer when one process renders multiple documents.
Generated rules are cached across calls while every call returns an independent
snapshot.

```ts
import { createServerRenderer } from '@master/css-server'

const renderer = createServerRenderer({ manifest })
const first = renderer.renderHTML('<div class="text-center"></div>')
const second = renderer.renderHTML('<div class="fg-red"></div>')

renderer.dispose()
```

Long-lived renderers cache up to 8192 unique classes before starting a new cache generation. Finite build jobs can pass `{ maxCachedClasses: Infinity }` and dispose the renderer when the build ends. Recreate the renderer whenever its manifest changes.

### `createHTMLRenderSession()`

Use one session per streaming document. `write()` accepts successive chunks and
`end()` returns the final transformed chunk plus the complete immutable snapshot.
The session owns its renderer and releases it after `end()`, failure, or `dispose()`.

```ts
import { createHTMLRenderSession } from '@master/css-server'

const session = createHTMLRenderSession({ manifest })
const firstChunk = session.write('<html><head>')
const final = session.end('</head><body class="block"></body></html>')
```

Use official framework integrations when possible; they compose this package with manifest loading, source scanning, and runtime hydration.

---
_Source: https://npm.io/package/@master/css-server · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
