Adoption path

Pick the budget that matches your release bar.

🟢 Start here

🟢 Recommended budget

Enable the practical baseline for teams that want performance warnings without a noisy first run.

Open config

🛡️ Tighten review

🛡️ Strict budget

Use the stricter public profile when performance regressions should block review earlier.

Open config

🟣 Full audit

🟣 All rules

Turn on every rule, including specialized audits for custom properties and fixed layers.

Open config

Rule lanes

Performance checks grouped by rendering risk.

Selector cost

Keep selector matching and parser work inside an explicit budget.

• • Heavy Selectors
• • Giant Selector Lists

Rendering pipeline

Catch declarations that push rendering back to layout or expensive paint paths.

• • Layout Thrashing
• • Paint-Heavy Declarations
• • Global Effects

Paint and motion

Flag filters, fixed surfaces, and animation targets that are costly during scroll or motion.

• • Filter Effects
• • Fixed Backgrounds
• • Expensive Motion
• • Reduced Motion

Governance checks

Surface hidden costs in imports, will-change hints, positioned layers, and custom values.

• • Render-Blocking Imports
• • Will-Change Abuse
• • Positioned Effects
• • Oversized Variables

Project surfaces

Docs, runtime metadata, and maintainer references are linked from the front page.

Install

• Getting started

Install the package, choose a config, and wire the plugin into an ESM Stylelint config.

Open section

Reference

• Rule catalog

Browse the full rule list with examples, options, and guidance for rollout decisions.

Open section

Maintain

• Developer docs

Inspect exported types, config contracts, and generated API documentation for maintainers.

Open section