Skip to content

skrulling/vite-plugin-biome

Repository files navigation

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

  • Integrates Biome linter, formatter, and checker into the Vite build process.
  • Supports different modes: linting, formatting, and checking.
  • Prints Biome output to the console.
  • Configurable to apply fixes and handle errors.
  • Reacts to hot reload

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

Option Description Values Default
mode The operation mode of the plugin lint, format, check lint
files File or glob pattern to process e.g., 'src/**/*.js' '.'
applyFixes Whether to apply fixes automatically true, false false
failOnError Whether to fail the build on lint errors true, false false

License

MIT LICENSE

GitHub

About

Vite plugin for using the Biome linter

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published