Astro Language Server

June 19, 2025 ยท View on GitHub

To enable Astro language support in your IDE, you can integrate the Astro Language Server by following these steps:

Astro LS demo


Step 1: Install the Language Server

  1. Open an .astro file in your project.

  2. Click on Install Astro Language Server:

    Open file

  3. This will open the New Language Server Dialog with Astro Language Server pre-selected:

    New Language Server Dialog

  4. Click OK. This will create the Astro Language Server definition and start the installation:

    Installing Language Server

  5. Once the installation completes, the server should start automatically and provide Astro language support (autocomplete, diagnostics, etc.).

Troubleshooting Installation

If the installation fails, you can customize the installation settings in the Installer tab,
then click on the Run Installation hyperlink to reinstall the server:

Installer tab

See Installer descriptor for more information.


Step 2: Install TextMate Bundle

Since IntelliJ does not provide native Astro TextMate support, and the language server does not handle syntax highlighting, you need to set up a TextMate bundle manually.

  • Clone the Astro language tools repository:

    git clone https://github.com/withastro/language-tools.git
    
    
  • Remove this snippets section from the package.json Otherwise, IntelliJ will fail to import the TextMate bundle.

  • Open TextMate Bundles settings

TextMate Bundles Settings

  • Click the + button and select the folder language-tools/packages/vscode folder. This folder contains the modified package.json and the TextMate grammar.

Once done, IntelliJ will apply syntax highlighting, bracket matching, and other basic editor features for .astro files.