Overview

Gleam Pro combines native Gleam editing with the official Gleam language server. Use it to navigate and refactor packages, run Erlang or JavaScript applications, explore test results, manage Hex dependencies, and debug JavaScript targets from Gleam source.

Requirements#

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

The documented release is 2026.2.4. Its Marketplace compatibility starts at IntelliJ Platform build 252.0. Check the Marketplace compatibility list for your IDE edition and version before installing.

Install Gleam and the runtime required by your target: Erlang/OTP for BEAM applications, or Node.js, Deno, or Bun for JavaScript. A managed compiler can be configured in the plugin. LSP4IJ supplies the language-server and debug-adapter integration. JavaScript debugging requires Gleam 1.16 or newer and source maps; standalone BEAM escript export requires Gleam 1.17 or newer.

Start here#

Install Gleam Pro, then follow Packages and editing. The configuration reference explains where to adjust the behavior for your project.

In this manual#

• Packages and editing — Open a Gleam package, navigate symbols, and refactor safely.
• Run, test, and debug — Run both targets, explore native test results, and debug JavaScript.

Feature guides#

Project setup#

• Toolchains and workspaces — Select compiler/runtime pairs and diagnose package detection.

Packages#

• Package graph and Hex dependencies — Add a dependency to the intended package and navigate its sources.

Editor#

• Completion and native refactoring — Navigate types and safely rename, extract, or move Gleam declarations.

Run and debug#

• Focused tests and the native test tree — Run a single gleeunit test and interpret package/module results.
• JavaScript source debugging and export — Bind Gleam breakpoints to generated JavaScript and inspect values.

Current limitations#

Source-level debugging covers JavaScript targets. It requires generated source maps and a compatible JavaScript debug adapter; installing a compiler alone does not enable debugging. Native analysis is a fallback when the language server cannot start, and does not replace compiler validation.

Release reference#

These instructions target the published 2026.2.4 release. Check the version under Settings → Plugins → Installed if your IDE behaves differently. For setup failures, start with troubleshooting.