biome-configuration

# Biome Configuration

Master Biome configuration including biome.json setup, schema versions, VCS integration, and project organization for optimal JavaScript/TypeScript tooling.

## Overview

Biome is a fast, modern toolchain for JavaScript and TypeScript projects that combines linting and formatting in a single tool. It's designed as a performant alternative to ESLint and Prettier, written in Rust for maximum speed.

## Installation and Setup

### Basic Installation

Install Biome in your project:

```bash
npm install --save-dev @biomejs/biome
# or
pnpm add -D @biomejs/biome
# or
yarn add -D @biomejs/biome
```

### Initialize Configuration

Create a basic biome.json configuration:

```bash
npx biome init
```

This creates a `biome.json` file in your project root.

## Configuration File Structure

### Basic biome.json

```json
{
  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
  "vcs": {
    "enabled": true,
    "clientKind": "git",
    "useIgnoreFile": true
  },
  "files": {
    "ignoreUnknown": false,
    "ignore": []
  },
  "formatter": {
    "enabled": true,
    "indentStyle": "space",
    "indentWidth": 2,
    "lineWidth": 80
  },
  "linter": {
    "enabled": true,
    "rules": {
      "recommended": true
    }
  },
  "javascript": {
    "formatter": {
      "quoteStyle": "single",
      "trailingCommas": "es5"
    }
  }
}
```

### Schema Versioning

Always use the correct schema version matching your Biome installation:

```bash
# Check Biome version
npx biome --version

# Migrate configuration to current version
npx biome migrate --write
```

The `$schema` field enables IDE autocomplete and validation:

```json
{
  "$schema": "https://biomejs.dev/schemas/2.3.6/schema.json"
}
```

### VCS Integration

Configure version control integration to respect .gitignore:

```json
{
  "vcs": {
    "enabled": true,
    "clientKind": "git",
    "useIgnoreFile": true,
    "defaultBranch": "main"
  }
}
```

Options:

- `enabled`: Enable VCS integration
- `clie