@koshikishi/eslint-config

The ESLint shareable config designed for my personal projects.

Use it as is or as a foundation for your own configuration file.

Prerequisites

This package requires:

• Node.js >= 24
• ESLint >= 10

Installation

Install the package and eslint in your project:

npm i -D eslint @koshikishi/eslint-config

Plugins

This config bundles the following plugins and uses additional rules from them:

• @stylistic/eslint-plugin to replace deprecated formatting rules
• eslint-plugin-check-file to enforce a consistent naming pattern
• eslint-plugin-n and eslint-plugin-unicorn for Node.js related rules

All plugins are direct dependencies and will be installed automatically.

Usage

This config is designed to validate Vanilla JS and Node.js projects and only supports flat (eslint.config.js) configuration files.

For validating your Vanilla JS project use the default config:

import {defineConfig} from 'eslint/config';
import config from '@koshikishi/eslint-config';

export default defineConfig([
  {
    extends: [config],
  },
]);

For validating your Node.js project use the node config:

import {defineConfig} from 'eslint/config';
import config from '@koshikishi/eslint-config/node';

export default defineConfig([
  {
    extends: [config],
  },
]);

Extending the config

Add a rules key to your config, then add your overrides and additions there.

For example, to add the no-eq-null rule and turn off the no-console rule:

import {defineConfig} from 'eslint/config';
import config from '@koshikishi/eslint-config';

export default defineConfig([
  {
    extends: [config],
    rules: {
      'no-eq-null': 'error',
      'no-console': 'off',
    },
  },
]);

You can also override the additional rules from plugins:

import {defineConfig} from 'eslint/config';
import config from '@koshikishi/eslint-config/node';

export default defineConfig([
  {
    extends: [config],
    rules: {
      '@stylistic/quotes': ['error', 'double'],
      'n/file-extension-in-import': 'off',
    },
  },
]);

Integration with VS Code

1. Install the ESLint extension for VS Code.
2. Install eslint and this config in your project following the Installation section.
3. Add an ESLint configuration file (eslint.config.js) and extend it with this shareable config following the Usage section.

Useful links

• Changelog
• ESLint documentation
• ESLint Stylistic