{"id":19831,"library":"eslint-plugin-matrix-org","title":"eslint-plugin-matrix-org","description":"ESLint plugin providing shareable configs and custom rules used by Matrix.org projects. Current stable version is 3.0.0. It codifies the code style from element-web and offers configs for JavaScript, TypeScript, Babel, React, and Jest. The plugin deliberately has zero runtime dependencies to avoid version conflicts; users must install peer dependencies manually. Key differentiator: it bundles multiple configs (Google, Prettier, unicorn, etc.) into a cohesive set aligned with Matrix.org's style guide.","status":"active","version":"3.0.0","language":"javascript","source_language":"en","source_url":"https://github.com/matrix-org/eslint-config-matrix-org","tags":["javascript","eslint"],"install":[{"cmd":"npm install eslint-plugin-matrix-org","lang":"bash","label":"npm"},{"cmd":"yarn add eslint-plugin-matrix-org","lang":"bash","label":"yarn"},{"cmd":"pnpm add eslint-plugin-matrix-org","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency; required to run ESLint","package":"eslint","optional":false},{"reason":"Peer dependency for TypeScript configs","package":"typescript","optional":true},{"reason":"Peer dependency for TypeScript configs","package":"@typescript-eslint/parser","optional":true},{"reason":"Peer dependency for TypeScript configs","package":"@typescript-eslint/eslint-plugin","optional":true},{"reason":"Peer dependency for React configs","package":"react","optional":true}],"imports":[{"note":"Use 'plugin:' prefix to reference configs from a plugin.","wrong":"extends: ['matrix-org/javascript']","symbol":"plugin:matrix-org/javascript","correct":"extends: ['plugin:matrix-org/javascript']"},{"note":"Use 'plugin:' prefix. Requires @typescript-eslint packages installed.","wrong":"extends: ['matrix-org/typescript']","symbol":"plugin:matrix-org/typescript","correct":"extends: ['plugin:matrix-org/typescript']"},{"note":"Use 'plugin:' prefix. Requires eslint-plugin-jest installed.","wrong":"extends: ['matrix-org/jest']","symbol":"plugin:matrix-org/jest","correct":"extends: ['plugin:matrix-org/jest']"}],"quickstart":{"code":"// .eslintrc.json\n{\n  \"plugins\": [\"matrix-org\"],\n  \"extends\": [\"plugin:matrix-org/javascript\"]\n}","lang":"javascript","description":"Basic ESLint configuration using the JavaScript config from eslint-plugin-matrix-org."},"warnings":[{"fix":"Downgrade ESLint to version 8 or use an older version of the plugin.","message":"Version 3.0.0 drops support for ESLint 9+; requires eslint <9.","severity":"breaking","affected_versions":">=3.0.0"},{"fix":"Replace 'plugin:matrix-org/a11y' with 'plugin:matrix-org/react'.","message":"Version 2.x removed the matrix-org/a11y config; use matrix-org/react instead.","severity":"deprecated","affected_versions":">=2.0.0"},{"fix":"Install all required peer dependencies listed in the README.","message":"Plugin has zero bundled dependencies; missing peer deps cause runtime errors.","severity":"gotcha","affected_versions":"*"},{"fix":"Add 'plugin:matrix-org/javascript' (or other) to your ESLint extends array.","message":"Configs are not automatically applied; you must specify them in extends.","severity":"gotcha","affected_versions":"*"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Run 'npm install eslint-plugin-matrix-org --save-dev'.","cause":"Plugin not installed.","error":"Error: Cannot find module 'eslint-plugin-matrix-org'"},{"fix":"Use 'plugin:matrix-org/javascript' instead.","cause":"Missing 'plugin:' prefix in extends.","error":"Error: Failed to load config 'matrix-org/javascript' to extend from."},{"fix":"Install '@typescript-eslint/parser' as a dev dependency.","cause":"Missing peer dependency for TypeScript config.","error":"Error: Cannot find module '@typescript-eslint/parser'"},{"fix":"Ensure the plugin is in 'plugins' array and use correct rule name.","cause":"Config or rule name misspelled or not loaded.","error":"Rule 'matrix-org/require-copyright-header' does not exist"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}