@browser-compat/postcss

PostCSS scanning and low-power CSS generation for the Browser Compat toolkit.

Browser Compat helps applications generate browser compatibility manifests from their own browserslist targets, check those manifests in CI, and use the result at runtime through small framework adapters.

What This Package Does

@browser-compat/postcss reports high-cost CSS declarations and can generate scoped low-power overrides.

It looks for declarations such as:

• animation and transition
• filter and backdrop-filter
• box-shadow and text-shadow
• scroll-behavior

Generated rules are scoped under .compat-low-power <selector> and avoid broad global selectors such as .compat-low-power *.

Most applications use this package through @browser-compat/cli.

Installation

npm install @browser-compat/postcss postcss

Usage

import { scanCompatCss } from "@browser-compat/postcss";

const report = await scanCompatCss({
  projectDir: process.cwd(),
  mode: "generate"
});

console.log(report.findings);
console.log(report.generatedCss);

Related Packages

• @browser-compat/cli can write CSS reports and generated low-power CSS.
• @browser-compat/runtime injects low-power compatibility classes.
• @browser-compat/react exposes runtime status to React apps.

Full documentation: https://github.com/relaxcloud-cn/browser-compat-package