@2bad/axiom

Axiom

Effortless TypeScript linting with zero configuration

Features

• Zero configuration required
• Comprehensive set of ESLint rules based on best practices
• Automatic management of ESLint plugins
• Customizable plugin selection
• Simplified setup process
• Consistent code style across projects

Overview

Axiom is a zero-configuration ESLint package that not only provides the best set of rules (inspired by StandardJS) but also manages other ESLint plugins. This removes the need for discussing and configuring ESLint rules, as well as maintaining and version tracking of various plugins.

With ESLint v9 flat configs, configurations can become complex, and mistakes can happen even in the setup. Axiom simplifies this process, allowing developers to focus on writing code rather than configuring linters.

Quick Start

• Install Axiom:

npm install --save-dev @2bad/axiom

• Create an eslint.config.mjs file in your project root:

import { axiom } from '@2bad/axiom'

export default axiom(import.meta.dirname)

You can also customize which plugins to enable:

import { axiom } from '@2bad/axiom'

// Disable vitest and node plugins
export default axiom(import.meta.dirname, {
  vitest: false,
  node: false
})

// Or enable only specific plugins
export default axiom(import.meta.dirname, {
  import: true,
  jsdoc: false,
  neostandard: false,
  node: false,
  promise: false,
  vitest: false
})

• Add a lint script to your package.json:

{
  "scripts": {
    "lint": "eslint .",
    "lint:fix": "eslint . --fix"
  }
}

• Run the linter:

npm run lint

Why Axiom?

Axiom aims to solve the following problems:

• Configuration Overload: With the multitude of ESLint plugins and rules available, configuring a linter can be overwhelming. Axiom provides a curated set of rules out of the box.

• Plugin Management: Keeping track of multiple ESLint plugins, their versions, and configurations can be time-consuming. Axiom manages this for you.

• Consistency: By providing a standard set of rules, Axiom ensures consistency across projects and team members.

• Focus on Code: Spend less time configuring and more time coding. Axiom handles the linting details so you can focus on writing great JavaScript.

Why "Axiom"?

In mathematics and logic, an axiom is a statement that is taken to be true without proof. Similarly, Axiom provides a set of linting rules that are considered best practices without the need for debate or configuration.

Contributing

Contributions are welcome! Please check out the issues or submit a pull request.