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:

Step 1: Install the Language Server
-
Open an
.astrofile in your project. -
Click on Install Astro Language Server:

-
This will open the New Language Server Dialog with
Astro Language Serverpre-selected:
-
Click OK. This will create the
Astro Language Serverdefinition and start the installation:
-
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:

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

- 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.