Getting Started

Install

npm install --save-dev stylelint stylelint-plugin-css-performance-budget

Use the 🟢 recommended config

import { performanceBudgetPluginConfigs } from "stylelint-plugin-css-performance-budget";

export default performanceBudgetPluginConfigs["performance-budget-recommended"];

See 🟢 performance-budget-recommended for the exact rule list, or compare all profiles in the config matrix.

Use plugin + explicit rules

import performanceBudgetPlugin from "stylelint-plugin-css-performance-budget";

export default {
 plugins: [...performanceBudgetPlugin],
 rules: {
  "css-performance-budget/no-layout-thrashing-properties": true,
  "css-performance-budget/no-paint-heavy-declarations": true,
 },
};

Next Steps

• Review the rule overview for the full catalog.
• Compare 🟢 recommended, 🛡️ strict, and 🟣 all configs.
• Use developer docs when changing package exports or generated docs surfaces.