Vite Plugin Biome

Run Biome inside your Vite dev loop.

vite-plugin-biome lets you lint, format, or check files with the Biome version already installed in your project. It runs on Vite startup and reacts to hot updates, so feedback shows up while you build instead of in a separate step.

By default, each hot update reruns Biome for the configured files scope. If you want faster feedback during development, you can opt into rerunning only the edited files.

Why Use It

• Keep Biome output inside the normal Vite workflow.
• Run lint, format, or check without wiring extra scripts into your day-to-day loop.
• Apply fixes automatically when you want them.
• Fail the build on Biome errors when you need stricter enforcement.
• Pass through extra Biome CLI args such as --changed or --config-path=....

AI-Assisted Development

This plugin is not AI-specific, but it fits well into AI-assisted workflows with tools like Cursor, Claude Code, Codex, and Windsurf. When generated edits touch many files quickly, keeping Biome in the Vite loop helps surface feedback immediately without changing your existing setup.

Compatibility

This plugin is compatible with:

• Biome: 1.8.0 and higher, including 2.x
• Vite: 4.x and higher
• Node.js: 16.x and higher

By default, the plugin resolves and runs the @biomejs/biome binary installed in your project. If you need to use a different command, override biomeCommandBase.

Installation

npm install -D vite-plugin-biome @biomejs/biome

Usage

Add the plugin to your vite.config.js or vite.config.ts file.

import { defineConfig } from 'vite';
import biomePlugin from 'vite-plugin-biome';

export default defineConfig({
  plugins: [biomePlugin()],
});

Common Setups

Fast Local Guardrails

Run Biome in lint mode during development.

import { defineConfig } from 'vite';
import biomePlugin from 'vite-plugin-biome';

export default defineConfig({
  plugins: [
    biomePlugin({
      mode: 'lint',
      files: '.',
    }),
  ],
});

Auto-Fix During Development

Run Biome in check mode and write fixes back to disk.

import { defineConfig } from 'vite';
import biomePlugin from 'vite-plugin-biome';

export default defineConfig({
  plugins: [
    biomePlugin({
      mode: 'check',
      files: '.',
      applyFixes: true,
    }),
  ],
});

Recheck Only Edited Files During HMR

Keep the initial startup run broad, but limit hot updates to the files you just edited.

import { defineConfig } from 'vite';
import biomePlugin from 'vite-plugin-biome';

export default defineConfig({
  plugins: [
    biomePlugin({
      mode: 'check',
      files: 'src',
      hotUpdateMode: 'changed',
    }),
  ],
});

Strict Build Feedback

Fail the build when Biome reports errors.

import { defineConfig } from 'vite';
import biomePlugin from 'vite-plugin-biome';

export default defineConfig({
  plugins: [
    biomePlugin({
      mode: 'check',
      failOnError: true,
    }),
  ],
});

Pass Extra Biome Arguments

Forward additional CLI args to Biome.

import { defineConfig } from 'vite';
import biomePlugin from 'vite-plugin-biome';

export default defineConfig({
  plugins: [
    biomePlugin({
      mode: 'check',
      biomeAdditionalArgs: '--changed',
    }),
  ],
});

Options

Option	Description	Values	Default
mode	The Biome command to run	lint, format, check	lint
files	File or glob pattern to process	e.g. 'src/**/*.js'	'.'
hotUpdateMode	How Vite hot updates trigger Biome. full reruns the configured scope on every change. changed reruns only edited files when possible, with a full fallback for Biome config changes. Startup still runs against the configured scope.	full, changed	full
applyFixes	Apply Biome fixes automatically	true, false	false
unsafe	Allow unsafe fixes, requires applyFixes	true, false	false
failOnError	Fail the build when Biome returns errors	true, false	false
forceColor	Force color output by adding --colors=force	true, false	true
diagnosticLevel	Minimum diagnostic level to show	info, warn, error	info
logKind	Output style for Biome logs	pretty, compact, check	pretty
biomeCommandBase	Override the command used to invoke Biome	e.g. 'npx @biomejs/biome'	Auto-resolved
biomeAdditionalArgs	Additional CLI arguments passed to Biome	e.g. '--changed --config-path=...'	—

License

MIT LICENSE

If this plugin saves you time, consider starring the repo: GitHub