Is it possible to enable plugins without overwriting default plugins?

[brandonleichty]

Hello! 👋

I'm looking to configure the [rules-of-hooks](https://oxc.rs/docs/guide/usage/linter/rules/react/rules-of-hooks.html#react-rules-of-hooks) plugin and I'm a bit confused by the docs.

The plugin documentation shows this setup:

{
    "plugins": ["react"],
    "rules": {
        "react/rules-of-hooks": "error"
    }
}

However, the [OXC plugin page](https://oxc.rs/docs/guide/usage/linter/plugins.html#enabling-plugins-in-a-configuration-file) has this note:

NOTE
Setting the plugins field will overwrite the base set of plugins. The plugins array should reflect all of the plugins you want to use.

My question is: if I add "plugins": ["react"] to use this rule, do I have to manually track down all the default plugins and add them to the array too?

Or can I just configure the rule like this and keep the defaults?

"rules": {
    "react/rules-of-hooks": "error"
}

[tt-a1i]

You don't need to specify all default plugins. Just configure the rule directly:

{
  "rules": {
    "react/rules-of-hooks": "error"
  }
}

Oxlint will automatically enable the necessary plugin when you reference a rule from it. The plugins field is only needed when you want to completely customize which plugins are active (e.g., to disable default plugins or enable all rules from a specific plugin at once).

So for your use case, the second approach (just adding the rule) is the correct one.

[brandonleichty]

Thanks a ton! 🙏

Maybe it's just me, but I feel like the wording in the docs could be improved around this.

[overlookmotel]

Agree! Can I ask a favour? Coudl you possibly submit a PR to https://github.com/oxc-project/oxc-project.github.io to improve the docs?

[silvenon]

Actually this is currently not true yet (or not anymore?), I hoped it worked this way, and I assume it's the desired behavior. I specified "plugins": ["vitest"] in my Vitest project, but the default jest/* rules were still running despite not being listed in "plugins" (I even checked via oxlint --print-config), so I had to disable them:

{
    "jest/expect-expect": "allow",
    "jest/no-conditional-expect": "allow",
    "jest/no-disabled-tests": "allow",
    "jest/no-export": "allow",
    "jest/no-focused-tests": "allow",
    "jest/no-standalone-expect": "allow",
    "jest/require-to-throw-message": "allow",
    "jest/valid-describe-callback": "allow",
    "jest/valid-expect": "allow",
    "jest/valid-title": "allow",
}