Skip to content

sublimelsp/LSP-biome

Repository files navigation

LSP-biome

Biome - One toolchain for your web project. Format, lint, and more in a fraction of a second.

  • Fast: Built with Rust and an innovative architecture inspired by rust-analyzer.
  • Scalable: Designed to handle codebases of any size. Focus on growing product instead of your tools.
  • Actionable & Informative: Avoid obscure error messages, when we tell you something is wrong, we tell you exactly where the problem is and how to fix it.
  • Simple: Zero configuration needed to get started. Extensive options available for when you need them.
  • Optimized: With tight internal integration we are able to reuse previous work and any improvement to one tool improves them all.
  • Batteries Included: Out of the box support for all the language features you use today. First class support for TypeScript and JSX.

Installation

  1. Install LSP and LSP-biome via Package Control.
  2. (Optional but recommended) Install LSP-file-watcher-chokidar via Package Control to enable functionality to notify the server about changes to the biome.json configuration file.
  3. Restart Sublime.

Configuration

Open the configuration file using the Command Palette Preferences: LSP-biome Settings command or from the Sublime menu.

Note Biome requires a configuration file (biome.json) in the root of the project to configure specific rules and other behavior. Refer to Configure Biome section in the official documentation.

Biome Resolution

The package tries to use Biome from your project's local dependencies (node_modules/.bin/biome). We recommend adding Biome as a project dependency to ensure that NPM scripts and the package use the same Biome version.

You can also explicitly specify the biome binary the package should use by configuring the biome.lspBin setting in LSP-biome Settings.

If the project has no dependency on Biome and no explicit path is configured, the package uses the bundled Biome version that it itself manages.

Usage

Linter

See more information on linting in the official documentation.

Format document

To format an entire document, open the Command Palette (Ctrl/++P) and select LSP: Format Document.

To format a text range, select the text you want to format, open the Command Palette (Ctrl/++P), and select LSP: Format Selection.

Fix on save

To enable fix on save, open Preferences: LSP Settings from the Command Palette and set:

{
    "lsp_code_actions_on_save": {
        "source.fixAll.biome": true,
    }
}

Imports Sorting

Biome has support for imports sorting through the "Organize Imports" code action. This action is accessible through the Command Palette (Ctrl/++P) by selecting LSP-biome: Organize Imports.

This feature is enabled by default but can be opted-out via biome.json configuration file:

{
    "organizeImports": {
        "enabled": false
    }
}

You can add the following to Preferences: LSP Settings if you want the action to run automatically on save instead of calling it manually:

{
    "lsp_code_actions_on_save":{
        "source.organizeImports.biome": true,
    }
}

Additional info

Please follow the official documentation for more information.