Skip to main content

Docusaurus-first linting for documentation repositories

eslint-plugin-docusaurus-2

A purpose-built ESLint plugin for Docusaurus config, themeConfig, navbar/footer schema, sidebars, pages, CSS boundaries, and TypeDoc-integrated docs workflows.

โš™๏ธConfig-first

Deployment, validation, navbar, footer, PWA, and themeConfig rules live together in one focused plugin.

๐ŸงญSidebar-safe

Category schemas, generated-index/doc link contracts, and duplicate doc assignment checks stay explicit.

๐ŸŽจSite-aware

Pages, CSS, static assets, and component-level Docusaurus link semantics are covered when you want them.

  • npm license
  • npm total downloads
  • latest GitHub release
  • GitHub stars
  • GitHub forks
  • GitHub open issues
  • Codecov

๐Ÿ“ Stable rule catalog

Docusaurus-specific checks without generic lint noise.

๐Ÿงฉ Flat-config presets

From minimal baseline to stricter site-wide enforcement.

๐Ÿ—‚๏ธ Docs-repo coverage

Config, sidebars, theme, pages, CSS, and TypeDoc docs.

๐Ÿš€ Start here

Pick the entry point that matches how you want to adopt the plugin: quick-start docs, the full rule catalog, preset guidance, or the maintainer-facing architecture docs.

๐Ÿš€

Get Started

Install the package, pick a preset, and understand what the plugin guarantees immediately.

Open section
๐Ÿ“

Rule Reference

Browse the hand-authored rule docs, rationale, and examples across the full Docusaurus rule catalog.

Open section
๐Ÿ› ๏ธ

Preset Guide

Compare minimal, config, recommended, strict, and the broader rollout tiers with a linked preset matrix.

Open section
๐Ÿงฐ

Maintainer Docs

Understand the docs app, generated API pages, site contract, and validation pipeline as a maintainer.

Open section

๐Ÿงญ What the plugin covers

The rule catalog is intentionally centered on the pain points unique to Docusaurus repositories: config shape, themeConfig semantics, sidebars, site-source boundaries, and TypeDoc-adjacent docs workflows.

โš™๏ธ

Config & theme rules

Top-level site config, deployment fields, plugin-pwa setup, validation severities, and theme-config metadata rules.

Explore rules
๐Ÿงญ

Sidebar & docs navigation

Sidebar category shape, category links, generated-index/doc semantics, duplicate doc assignment, and collapse-state hygiene.

Explore rules
๐ŸŽจ

Site-source architecture

Component link semantics, page module contracts, CSS boundaries, and static asset usage for mature docs sites.

Explore rules