Skip to main content

Maintainer quickstart

This quickstart assumes Node 22+ and npm 11+.

1) Install dependenciesโ€‹

npm install

2) Build the plugin onceโ€‹

npm run build

3) Run core quality checksโ€‹

npm run typecheck
npm run test
npm run lint:all

4) Run docs locallyโ€‹

npm run docs:api
npm run --workspace docs/docusaurus start

5) Keep generated docs/tables in syncโ€‹

npm run sync:readme-rules-table

Useful targetsโ€‹

  • npm run docs:build โ€” full docs production build
  • npm run verify:readme-rules-table โ€” validates README rules section sync
  • npm run test:coverage โ€” coverage run

Before opening a PRโ€‹

  • Ensure typecheck, lint, tests, and docs build are green locally.
  • Include tests for behavioral changes.
  • Update docs for user-facing changes.