Shared ESLint config I use on my personal projects. Based on antfu's config.
- Format with Prettier
- Only the tools I use are supported
- More stricter rules
- Simpler setup
- Play well with TypeScript and Prettier
- Target tools I use personally on the majority of the projects: React, Next, Astro and Vitest
- Sort imports,
package.json,tsconfig.json - ESLint flat config for better organization and composition
- Respects
.gitignoreby default - Reasonable defaults, best practices, only one-line of config
- Requires ESLint v9.5.0+
pnpm add -D eslint@latest @nicksp/eslint-configCreate eslint.config.mjs in your project root:
import { defineConfig } from '@nicksp/eslint-config'
export default defineConfig()Add scripts for package.json:
{
"scripts": {
"lint": "eslint",
"lint:fix": "eslint --fix",
"format": "prettier --write \"**/*.{js,cjs,mjs,jsx,ts,tsx,astro,css,json,md}\""
}
}Configure VS Code for auto-fix on save in .vscode/settings.json:
// eslint.config.js
import { defineConfig } from '@nicksp/eslint-config'
export default defineConfig(
{
// Type of the project. 'lib' for libraries, the default is 'app'
type: 'lib',
// Formatting with Prettier is enabled by default, you can disable it
prettier: false,
// TypeScript is autodetected, you can also explicitly enable it
typescript: true,
// Disable jsx support
jsx: false,
// You can configure each integration individually as well
yaml: {
overrides: {
// ...
},
},
ignores: [
'**/fixtures',
// ...globs
]
},
// You can have multiple config overrides
{
files: ['**/*.ts'],
rules: {},
},
{
rules: {},
},
)
// Advanced config
// See more at https://github.com/antfu/eslint-flat-config-utils
.prepend(
// some configs before the main config
).removeRules('foo/bar')These are optional configs for specific use cases.
Running npx eslint should prompt you to install the required dependencies, otherwise, you can install them manually.
// eslint.config.js
import { defineConfig } from '@nicksp/eslint-config'
export default defineConfig({
// Enable React support
react: true,
// Enable Next.js support
nextjs: true,
// Enable Astro support
astro: true,
})- nicksp/dotfiles - My dotfiles and VS Code settings
- nicksp/prettier - My Prettier config
MIT License © 2025 Nick Plekhanov
{ // Use the Prettier formatter "editor.defaultFormatter": "esbenp.prettier-vscode", "editor.formatOnSave": true, // Autosave files on focus change "files.autoSave": "onFocusChange", // Don’t autosave files with syntax errors "files.autoSaveWhenNoErrors": true, // Auto fix "editor.codeActionsOnSave": { "source.fixAll.eslint": "explicit", "source.organizeImports": "never" }, // Silent the stylistic rules in your IDE, but still auto fix them "eslint.rules.customizations": [ { "rule": "style/*", "severity": "off", "fixable": true }, { "rule": "format/*", "severity": "off", "fixable": true }, { "rule": "*-indent", "severity": "off", "fixable": true }, { "rule": "*-spacing", "severity": "off", "fixable": true }, { "rule": "*-spaces", "severity": "off", "fixable": true }, { "rule": "*-order", "severity": "off", "fixable": true }, { "rule": "*-dangle", "severity": "off", "fixable": true }, { "rule": "*-newline", "severity": "off", "fixable": true }, { "rule": "*quotes", "severity": "off", "fixable": true }, { "rule": "*semi", "severity": "off", "fixable": true } ], // Enable eslint for all supported languages "eslint.validate": [ "javascript", "javascriptreact", "typescript", "typescriptreact", "html", "markdown", "json", "json5", "jsonc", "yaml", "toml", "xml", "gql", "graphql", "astro", "css", "less", "scss", "pcss", "postcss" ] }