Formatter

Biome is an opinionated formatter that supports multiple languages. It follows a similar philosophy to Prettier, only supporting a few options to avoid debates over styles, turning into debates over Biome options. It deliberately resists the urge to add new options to prevent bike-shed discussions in teams so they can focus on what really matters instead.

CLI

The following command checks the formatting of the files in the src directory. It emits text differences if it finds code that is not formatted.

npm

npx @biomejs/biome format ./src

pnpm

pnpm exec biome format ./src

bun

bunx --bun biome format ./src

deno

deno run -A npm:@biomejs/biome format ./src

yarn

yarn exec biome format ./src

If you want to apply the new formatting, pass the --write option:

npm

npx @biomejs/biome format --write ./src

pnpm

pnpm exec biome format --write ./src

bun

bunx --bun biome format --write ./src

deno

deno run -A npm:@biomejs/biome format --write ./src

yarn

yarn exec biome format --write ./src

The command accepts a list of files and directories.

Caution

If you pass a glob as a parameter, your shell will expand it. The result of the expansion depends on your shell. For example, some shells don’t support the recursive glob ** or the alternation {} in the following command:

biome format ./src/**/*.test.{js,ts}

Shell expansion has a performance cost and a limit on the number of files you can pass to the command.

For more information about all the available options, check the CLI reference.

Options

Biome provides some options to tune the behavior of its formatter. Differently from other tools, Biome separates language-agnostic options from language-specific options.

The formatter options can be set on the CLI or via a Biome configuration file. As of v1.9, Biome supports loading .editorconfig files.

It’s recommended to use a Biome configuration file to ensure that both the Biome CLI and the Biome LSP apply the same options. The following defaults are applied:

biome.json

{
  "formatter": {
    "enabled": true,
    "formatWithErrors": false,
    "ignore": [],
    "attributePosition": "auto",
    "indentStyle": "tab",
    "indentWidth": 2,
    "lineWidth": 80,
    "lineEnding": "lf"
  },
  "javascript": {
    "formatter": {
      "arrowParentheses":"always",
      "bracketSameLine": false,
      "bracketSpacing": true,
      "jsxQuoteStyle": "double",
      "quoteProperties": "asNeeded",
      "semicolons": "always",
      "trailingCommas": "all"
    }
  },
  "json": {
    "formatter": {
      "trailingCommas": "none"
    }
  }
}

The main language-agnostic options supported by the Biome formatter are:

• indent style (default: tab): Use spaces or tabs for indentation;
• indent width (default: 2): The number of spaces per indentation level.
• line width (default: 80): The column width at which Biome wraps code;

See the configuration reference for more details.

Ignore Code

There are times when the formatted code isn’t ideal.

Ignore an entire file

You can suppress (ignore) the formatter for an entire file by using the biome-ignore-all format: reason comment at the top of the file:

For example, in JavaScript:

example.js

// biome-ignore-all format: generated file

const expr1 =
  [
    (2 * n) / (r - l),
    0,
    (r + l) / (r - l),
    -1,
    0,
  ];


const expr2 =
  [
    (2 * n) / (r - l),
    0,
    (r + l) / (r - l),
    -1,
    0,
  ];

Ignore nodes

In case you want to suppress only a portion (node) of the code, use the suppression comment biome-ignore format: reason

example.js

// biome-ignore format: reason

Example:

example.js

const expr =
  // biome-ignore format: the array should not be formatted
  [
    (2 * n) / (r - l),
    0,
    (r + l) / (r - l),
    0,
    0,
    (2 * n) / (t - b),
    (t + b) / (t - b),
    0,
    0,
    0,
    -(f + n) / (f - n),
    -(2 * f * n) / (f - n),
    0,
    0,
    -1,
    0,
  ];