@kumix/eslint-config-vite

ESLint configuration for Vite projects with React Refresh support.

This package is only available via ES Modules and requires ESLint 9 or greater, since it uses flat configs.

Installation

bun add -D @kumix/eslint-config-vite eslint typescript

Configurations

This package provides one composed configuration:

• viteFast - @kumix/eslint-config-react reactFast preset with the Vite/React Refresh layer on top

Recommended Starter Configuration

For most Vite React projects, use the fast configuration with TypeScript project settings:

// eslint.config.js
import { configs } from "@kumix/eslint-config-vite";

export default [
  // Fast configuration optimized for Biome (recommended)
  ...configs.viteFast,
  {
    languageOptions: {
      parserOptions: {
        tsconfigRootDir: import.meta.dirname,
      },
    },
  },
];

React Refresh Plugin

This configuration adds the eslint-plugin-react-refresh plugin to ensure your React components work properly with Vite's Hot Module Replacement (HMR):

Key Rules

• react-refresh/only-export-components - Warns when files export things other than React components, which can break HMR
  • Uses the plugin's configs.vite preset defaults

Biome Integration

When using viteFast, you get the React and Vite-specific rules with the performance benefits from the base fast configuration. For optimal performance, use @kumix/biome-config alongside the fast configuration:

bun add -D @kumix/biome-config @biomejs/biome

// biome.jsonc
{
  "$schema": "https://biomejs.dev/schemas/latest/schema.json",
  "extends": ["@kumix/biome-config/base"],
}

Vite-Specific Rules

viteFast adds the Vite/React Refresh layer on top of the React config:

Vite & React-Specific Rules

Both presets add the same layers, since Biome has no equivalents:

• Everything from @kumix/eslint-config-react (React, React Hooks, TanStack Query)
• TanStack Router linting (@tanstack/eslint-plugin-router, flat/recommended)
• React Refresh rules for Vite HMR (eslint-plugin-react-refresh, configs.vite)

See the @kumix/eslint-config README for the full list of rules handled by Biome.

Links

• npm Package
• Contributing Guide
• Code of Conduct
• License

License

MIT © Kumix Labs