README

👁 .github/workflows/ci.yaml
👁 Packagist Version

A Symfony Bundle to easily download and use Biome.js in your Symfony applications, to lint your front assets without needing Node.js (ex: when using Symfony AssetMapper).

Tip

If you prefer to use Oxlint instead, check Kocal/OxlintBundle!

Note

This documentation is for version ^2.0. You can check the previous documentation for ^1.0 here.

Installation

Install the bundle with Composer:

composer require kocal/biome-js-bundle --dev

If you use Symfony Flex, everything must be configured automatically. If that's not the case, please follow the next steps:

Configuration

The bundle is configured in the config/packages/kocal_biome_js.yaml file:

when@dev:
 kocal_biome_js:
 
 # The Biome.js CLI version to use, that you can find at https://github.com/biomejs/biome/tags:
 # - for >=2.0.0 versions, the git tag follows the pattern "@biomejs/biome@VERSION"
 # - for <2.0.0 versions, the git tag follows the pattern "cli/VERSION"
 binary_version: '2.0.0' # required

Usage

biomejs:download

Download the Biome.js CLI binary for your configured version, and for your platform (Linux, macOS, Windows).

By default, the command will download the binary in the bin/ directory of your project.

php bin/console biomejs:download
bin/biome --version

# or, with a custom destination directory
php bin/console biomejs:download path/to/bin
path/to/bin/biome --version

Inspirations

• https://github.com/SymfonyCasts/tailwind-bundle