Configuração de npm-scripts do Biome

Este é o padrão de npm-scripts que você quase sempre configura ao introduzir o Biome em um projeto. Ele trata tanto lint quanto format de forma uniforme usando o comando biome check.

Configuração básica

{
  "scripts": {
    "lint": "biome check .",
    "format": "biome check . --write"
  }
}

Agrupamento com prefixos

Em projetos com muitos npm-scripts, o agrupamento com prefixos facilita a organização.

{
  "scripts": {
    "code:lint": "biome check .",
    "code:format": "biome check . --write"
  }
}

Diferenças entre os comandos

Comando	Comportamento
biome check .	Detecta problemas e os reporta, código de saída é não-zero em caso de erro
biome check . —write	Corrige problemas auto-corrigíveis
biome format .	Executa apenas a formatação
biome lint .	Executa apenas o linting

check executa tanto lint quanto format. É comum usar check . em CI e --write durante o desenvolvimento.

Exemplo de uso em CI

Exemplo de configuração no GitHub Actions:

- name: Verificar código
  run: npm run lint

- name: Verificar formatação
  run: npx biome format . --check

Ou use check --changed para validar apenas arquivos modificados:

{
  "scripts": {
    "lint:changed": "biome check --changed ."
  }
}

Isso permite que você direcione apenas o diff e reduza o tempo de processamento.

Relação com arquivos de configuração

Configure detalhes em biome.json:

{
  "formatter": {
    "indentStyle": "space",
    "indentWidth": 2
  },
  "linter": {
    "enabled": true,
    "rules": {
      "recommended": true
    }
  }
}

É melhor manter os npm-scripts simples como pontos de entrada e delegar a configuração detalhada para o arquivo de configuração.