eslint-config-minsug

소개

eslint-config-minsug는 TypeScript + React 프로젝트를 위한 ESLint 9 플랫(Flat) 구성 공유 패키지입니다. 실사용 현장에서 검증된 추천 규칙과 import/정렬, Prettier 연동을 함께 제공하므로 별도 설정 없이 일관된 코드 품질을 확보할 수 있습니다.

요구 사항

• eslint 9 이상 (Flat Config 전용)
• ESM 기반 구성 파일(eslint.config.js 또는 eslint.config.mjs)
• 프로젝트에 tsconfig.json이 존재해야 typescript-eslint 타입 체크 규칙이 활성화됩니다.

설치

npm install --save-dev eslint@^9 eslint-config-minsug
# 또는 pnpm/yarn 등 선호하는 패키지 매니저 사용

사용 예시 (Flat Config)

// eslint.config.mjs
import minsugConfig from "eslint-config-minsug";

const [ignoreConfig, baseConfig] = minsugConfig;

export default [
  ignoreConfig,
  {
    ...baseConfig,
    files: ["**/*.{ts,tsx,js,jsx}"],
  },
];

또는

import { defineConfig } from "eslint/config";
import minsugConfig from "eslint-config-minsug";

export default defineConfig([
  { files: ["**/*.{ts,tsx,js,jsx}"], extends: [minsugConfig] },
]);

위 예시는 dist 디렉터리를 전역 제외 대상으로 유지하면서 TypeScript/JavaScript/React 파일에만 규칙을 적용합니다.

포함된 주요 규칙

• 기본 세트: @eslint/js의 recommended, typescript-eslint의 recommendedTypeChecked
• React & UI: eslint-plugin-react, eslint-plugin-react-hooks 최신 추천, eslint-plugin-jsx-a11y
• Import 품질: eslint-plugin-import, eslint-plugin-unused-imports, eslint-plugin-simple-import-sort
• 코드 포맷: eslint-plugin-prettier로 Prettier 포맷 오류를 ESLint 에러로 처리
• 팀 컨벤션: _ prefix 파라미터 허용, no-console은 warn/error만 예외, 타입 import 일관성과 switch exhaustiveness 강제