Home

Awesome

Vite Plugin Biome

This is a Vite plugin for integrating the Biome linter into your Vite project. It allows you to lint, format, or check your project files using Biome directly within the Vite build process. It is much faster than eslint.

Features

Installation

npm install vite-plugin-biome @biomejs/biome

Usage

First, add the plugin to your vite.config.js file. You can specify the mode (lint, format, check), the files to be processed, and other options.

Basic Usage

For basic linting:

import biomePlugin from 'vite-plugin-biome';

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

Advanced Usage

Linting

To lint files without applying fixes:

import biomePlugin from 'vite-plugin-biome';

export default {
  plugins: [biomePlugin({
    mode: 'lint',
    files: '.' // This is the default, it will lint all files in a project
  })],
};

Formatting

To format and write changes to files:

import biomePlugin from 'vite-plugin-biome';

export default {
  plugins: [biomePlugin({
    mode: 'format',
    files: 'src/**/*.js', // Format only JavaScript files in src
    applyFixes: true
  })],
};

Checking

To perform both linting and formatting with applied fixes:

import biomePlugin from 'vite-plugin-biome';

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

Options

OptionDescriptionValuesDefault
modeThe operation mode of the pluginlint, format, checklint
filesFile or glob pattern to processe.g., 'src/**/*.js''.'
applyFixesWhether to apply fixes automaticallytrue, falsefalse
failOnErrorWhether to fail the build on lint errorstrue, falsefalse

License

MIT LICENSE

GitHub