Skip to content

Getting Started

This library is a modular ESLint 10+ flat-config toolchain. The main entry point is @santi020k/eslint-config-basic, and framework packages are added explicitly when you need them.

Requirements

  • Node.js >=18.18.0
  • ESLint 10+

Install the Base Package

bash
npm install -D eslint @santi020k/eslint-config-basic

Create an eslint.config.mjs file, or eslint.config.js if your project uses "type": "module".

js
import { eslintConfig } from '@santi020k/eslint-config-basic'

export default eslintConfig()

Understand the Package Layout

  • @santi020k/eslint-config-basic is the main package.
  • Framework packages such as React, Next.js, Astro, Vue, and NestJS are installed only when needed.
  • Optional integrations are enabled through enums from the main package instead of separate config objects in application code.

Choose Your Workflow

  • Use the base package alone for core JavaScript, TypeScript, runtime detection, and optional integrations.
  • Add framework packages like React, Next.js, Astro, or Vue when your project needs them.
  • Use the CLI if you want a scaffolded config with detected integrations.

Pick the Right Starting Point

  • Use Configuration when you want to compose the config manually.
  • Use CLI when you want a generated starting file.
  • Use Frameworks when you already know the application stack.
  • Use Optional Tooling when the main need is integrating Tailwind, Vitest, Prettier, Markdown, Unicorn, or similar packages.
  • Use Packages when you want to understand how the monorepo is organized.

Canonical Package Entry Points

Next Steps

Built by Santi020k. Repo and personal site linked throughout the docs.