https://github.com/pbr1111/vite-plugin-biome
Vite plugin to run biome.js
https://github.com/pbr1111/vite-plugin-biome
biome biomejs plugin vite vite-biome
Last synced: 5 months ago
JSON representation
Vite plugin to run biome.js
- Host: GitHub
- URL: https://github.com/pbr1111/vite-plugin-biome
- Owner: pbr1111
- Created: 2024-04-15T18:16:52.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-10-18T06:41:01.000Z (12 months ago)
- Last Synced: 2025-04-18T01:52:42.899Z (6 months ago)
- Topics: biome, biomejs, plugin, vite, vite-biome
- Language: TypeScript
- Homepage:
- Size: 61.5 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# @pbr1111/vite-plugin-biome
[](https://badge.fury.io/js/%40pbr1111%2Fvite-plugin-biome)
This Vite plugin seamlessly integrates the Biome linter, formatter, and checker into your development workflow, providing lightning-fast code analysis and formatting directly within the build process.
## Features
- **Blazing-Fast Linting**: Experience significantly faster linting compared to traditional linters like ESLint.
- **Versatile Modes**: Choose between linting (lint), formatting (format), and checking (check) Biome to tailor the plugin to your needs.
- **Streamlined Configuration**: Define options for mode, path, applying fixes, and error handling for a customized setup.
- **Hot Reload Support**: The plugin automatically re-runs Biome when file changes occur during hot module replacement
## Installation
1. Install the plugin using npm/yarn/pnpm:
- npm: `npm install -D @pbr1111/vite-plugin-biome`
- yarn: `yarn add @pbr1111/vite-plugin-biome -D`
- pnpm: `pnpm add -D @pbr1111/vite-plugin-biome`
2. Add the plugin to your vite.config.js/ts file:
```ts
import { defineConfig } from 'vite';
import { biomePlugin } from '@pbr1111/vite-plugin-biome';
export default defineConfig({
plugins: [biomePlugin()],
});
```
## Usage
By default, the plugin runs Biome in linting mode (lint) on your entire project. You can customize its behavior using options:
- `mode`: Specify the Biome mode (`lint`, `format`, or `check`). Defaults to `lint`.
- `path`: Define the path to the files or directories you want to process. Defaults to the current working directory (`.`).
- `applyFixes`: Set to `true` to apply Biome's formatting or fixing suggestions (depends on mode). Defaults to `false`.
- `errorOnWarnings`: Set to `true` to threat warnings as errors. Defaults to `false`.
- `failOnError`: Set to `true` to throw an error when Biome encounters issues. Defaults to `process.env.NODE_ENV === 'production'`.
- `useServer`: Set to `true` to reuse the LSP proxy server in each execution. Defaults to `false`.
- `verbose`: Set to `true` to print additional diagnostics and some diagnostics show more information. Defaults to `false`.
- `args`: Pass extra arguments to the command (https://biomejs.dev/reference/cli/). Check Defaults to `''`.