Skip to main content

Biome

Official module: dagger/biomejs

Install with dagger mod install github.com/dagger/biomejs.

What It Is​

The Biome module runs Biome linting and can return fixed source.

Use it when a project uses Biome as the main code quality tool instead of separate lint and formatting tools.

Use It For​

  • Check JavaScript and TypeScript projects.
  • Run one combined tool for lint and format rules.
  • Generate a fixed version of the source when Biome can repair issues.

Main Workflows​

  • lint: run Biome and fail on lint issues.
  • fix: return source with fixable issues repaired.

How to Use It​

Install the module, then run its check:

dagger mod install github.com/dagger/biomejs

dagger check              # run every check in the workspace
dagger check biomejs:lint # run Biome against the workspace source

lint installs dependencies and runs biome check over the whole workspace using the project's own biome.json. Biome's check covers both linting and formatting, which is why this single check replaces a separate ESLint and Prettier pair.

Settings​

List the current settings and their values with dagger settings biomejs, then set one with dagger settings biomejs <key> <value>. Settings are stored in .dagger/config.toml under [modules.biomejs.settings].

  • baseImageAddress (default node:25-alpine): the Node base image Biome runs in. Pin it to the project's Node version, for example node:22-alpine. Biome installs with npm, so unlike the ESLint and Prettier modules there is no package-manager setting.
[modules.biomejs.settings]
baseImageAddress = "node:22-alpine"

Fixing issues​

Biome also exposes a fix function that runs biome check --write and returns the repaired source as a changeset (covering .js, .ts, .jsx, .tsx). It is a regular function rather than a check, so it does not run during dagger check; call it with dagger function call (run dagger function list to see available functions).

Workspace Fit​

Use Biome for projects that already have Biome config. Keep ESLint and Prettier pages for projects that use those tools separately.

Source​

Source repo: github.com/dagger/biomejs