Skip to article
Documentation

Installation

Install Astro Pro, prepare its dependencies, and verify your setup.

On this page

Install from Marketplace#

  1. Open Settings → Plugins → Marketplace in your JetBrains IDE. On macOS, Settings is in the application menu.
  2. Search for Astro Pro, or open the product on JetBrains Marketplace to identify the correct listing.
  3. Choose Install and accept any required plugin dependencies. Restart the IDE if prompted.
  4. If the IDE requests activation, start the offered trial or sign in with the JetBrains Account that holds your subscription. The IDE’s plugin licensing dialog shows the options available for this product.
  5. Open the project directory rather than an isolated file so project-aware features can resolve dependencies and configuration.

Prepare the environment#

IDE compatibility: WebStorm 2025.2+. Check the Marketplace list for other editions and their supported versions.

Install the project’s Node.js dependencies to run Astro or its language server. LSP4IJ is optional for installation but required for language-server-backed TypeScript, diagnostics, and refactoring. Use LSP4IJ 0.21.0 or newer on IntelliJ Platform 2026.2. Native editing remains available without it.

The approved release documented here is 2026.1.5, for platform build 252.0 or newer. The Marketplace Versions tab lists compatible downloads for individual IDE editions. An older IDE may receive an older compatible plugin with different features.

Verify the installation#

Open Settings → Plugins → Installed and confirm that Astro Pro is enabled. Then follow Editing and navigation to exercise the main workflow. Expected results and the necessary project files are described there.

Install a downloaded archive#

For an offline installation, download a compatible ZIP from the Marketplace versions page. In Settings → Plugins, open the gear menu, choose Install Plugin from Disk…, select the ZIP without unpacking it, and restart if requested. Required dependencies and external tools must also be available.

Update or uninstall#

Use Settings → Plugins → Installed to update, disable, or uninstall the plugin. Restart when requested. Keep your project sources and configuration in version control before applying updates that change generated files or external-tool behavior.

Manual for version 2026.1.5 · Reviewed