 Stylelint template for Docusaurus teams 

stylelint-plugin-docusaurus

A Stylelint-first plugin scaffold for Docusaurus stylesheets, built around Stylelint and Docusaurus styling.

Stylelint-native

Built around Stylelint's native plugin-pack model and ESM config authoring.

Docusaurus-aware

Focused on Docusaurus theme tokens, Infima usage, and component CSS boundaries.

Template-ready

Template-first infrastructure for rules, docs, sync scripts, and tests.

󰜝 Start with Overview 󱒒 Explore Configs

 33 Public Rules

The plugin now ships focused guardrails for theme scopes, CSS Modules boundaries, selector stability, color mode, DocSearch pairing, navbar/mobile behavior, cascade-layer safety, and Infima token usage.

 3 Shareable Configs

Start with a conservative default or opt into the full stable catalog later.

󰁨 DX-first Template

Typed helper scaffolding, docs sync, and Vitest integration are already in place.



Get Started

Install the package, enable a shareable config, and understand the plugin-pack export shape.

Open section →



Configs

Compare the exported configs and understand why `recommended` stays conservative while `all` adds stricter opt-in rules.

Open section →



Current Status

Read the migration status and template roadmap before designing the first public Docusaurus rules.

Open section →