@amedia/kragl-biome

Biome runner for kragl. Experimental drop-in replacement for the ESLint + Prettier runners.

Talk to #fag-front before adopting Biome in production.

Install

npm install --save-dev @amedia/kragl-cli @amedia/kragl-biome @amedia/biome-config

@amedia/kragl-cli is the kragl command without the ESLint and Prettier runners that @amedia/kragl brings along. With @amedia/kragl installed as well, kragl lint runs ESLint, Prettier and Biome.

Add scripts to package.json:

{
  "scripts": {
    "format": "kragl format",
    "lint": "kragl lint",
    "lint:fix": "kragl lint --fix"
  }
}

Use

Write biome.json to the project root:

npx kragl install --biome

It extends the shared configuration:

{
  "$schema": "https://biomejs.dev/schemas/2.5.15/schema.json",
  "extends": ["@amedia/biome-config"]
}

Without a biome.json, kragl uses the shared configuration as is.

Optionally ignore files:

{
  "files": {
    "ignore": ["**/node_modules", "**/dist"]
  }
}

Notes

Requires Node 22+ and Biome 2.5+. When migrating from ESLint + Prettier, disable or remove those editor extensions and delete their config files.

For VS Code:

// .vscode/settings.json
{
  "editor.defaultFormatter": "biomejs.biome"
}