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.
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.
If you want to apply the new formatting, pass the --write
option:
The command accepts a list of files and directories.
For more information about all the available options, check the CLI reference.
Options
Section titled OptionsBiome 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 in the biome.json
configuration file.
Biome doesn’t support .editorconfig
yet.
It’s recommended to use the configuration file to ensure that both the Biome CLI and the Biome LSP apply the same options. The following defaults are applied:
The main language-agnostic options supported by the Biome formatter are:
- indent style (default:
tab
): Use spaces or tabs for indention; - indent width (default:
2
): The number of spaces per indention level. - line width (default:
80
): The column width at which Biome wraps code;
See the configuration reference for more details.
Ignoring Code
Section titled Ignoring CodeThere are times when the formatted code isn’t ideal.
For these cases, you can use a format suppression comment:
Example:
Ignoring files
Section titled Ignoring filesBiome doesn’t provide ignore comments that ignore an entire file. However, you can ignore a file using the Biome configuration file.
You can ignore files for all tools, including the formatter,
using the files.ignore
configuration.
By default, Biome ignores the protected files.
If you want to exclude files from being formatted, you can use formatter.ignore
:
Note that you can also ignore files ignored by your VCS.