From 4d4f5ee8770f0c1882329c8fa182af27c8be831d Mon Sep 17 00:00:00 2001 From: Max Rydahl Andersen Date: Sun, 23 Aug 2026 11:14:30 +0200 Subject: [PATCH] feat: refresh IDE page with install steps, merge VS Code/VSCodium tabs, click-to-copy inline code - Merge VSCodium and VS Code into one tab with separate marketplace links - Add step-by-step install instructions for IntelliJ (including EAP channel) - Add install steps and feature list for Eclipse - Tighten Zed/Vim/Emacs tabs with code blocks - Fix broken Zed and repl.it icons (use simpleicons.org) - Extend global click-to-copy to inline elements --- content/ide.html | 142 ++++++++++++++++++++-------- templates/partials/head/custom.html | 10 +- 2 files changed, 106 insertions(+), 46 deletions(-) diff --git a/content/ide.html b/content/ide.html index 73d8b9da9..fc0c9229c 100644 --- a/content/ide.html +++ b/content/ide.html @@ -16,92 +16,150 @@

JBang IDE Support

{|
- - - + + - + - +
-

VSCodium

+

VS Code / VSCodium

- VSCodium is a community-driven, freely-licensed binary distribution of Microsoft's editor Visual Studio Code. - Providing all the lightweight editor features you need to get started. + The JBang extension works in both Visual Studio Code and + VSCodium (a free, open-source VS Code distribution). + Running jbang edit installs VSCodium by default with Java and JBang extensions pre-configured — ready to code immediately.

-

- jbang edit will by default install VSCodium; a free distribution of Visual Studio Code. It provides - a good default set of extensions to have it configured to use with Java/JBang. -

-

- JBang is in Open VSX Registry -

-
-
-

Visual Studio Code

-

- Visual Studio Code is a lightweight but powerful source code editor which runs on your desktop and is available for Windows, macOS and Linux. -

+

Install

+

Quickest: just run jbang edit hello.java — JBang installs VSCodium and the required extensions automatically.

+

Manual install in VS Code: install JBang from the VS Marketplace.

+

Manual install in VSCodium: install JBang from Open VSX.

+ +

Features

+
    +
  • Automatic classpath synchronization from JBang directives
  • +
  • Completion for //DEPS, //SOURCES, //FILES, and options
  • +
  • Run and Debug via CodeLens
  • +
  • Create scripts from templates, export native binaries, install as apps
  • +
  • Per-script projects with java.import.jbang.projectPerScript
  • +
  • Automatic annotation processor configuration
  • +
  • build.jbang and jbang-catalog.json support
  • +
+ +

Documentation

- JBang is on Visual Studio Marketplace + Full documentation · + Source on GitHub

-

IntelliJ

-

- IntelliJ IDEA is a very popular Java IDE. Has a lot of features; especially when it comes to refactoring and code assists. -

-

- JBang is on Jetbrains Marketplace +

IntelliJ IDEA

+

+ The JBang plugin makes Java, Kotlin, Groovy, JShell, and .jbang scripts first-class citizens in IntelliJ IDEA. + It uses jbang info tools as the single source of truth — no module mutation, no Gradle/Maven modification. +

+ +

Install

+

From Marketplace:

+
    +
  1. SettingsPluginsMarketplace → search "JBang"Install
  2. +
  3. Restart IntelliJ IDEA
  4. +
  5. Open a folder with JBang scripts — the plugin auto-detects and syncs
  6. +
+ +

Early Access (EAP channel):

+
    +
  1. SettingsPluginsManage Plugin Repositories…
  2. +
  3. Add: https://plugins.jetbrains.com/plugins/eap/18257
  4. +
  5. Search "JBang" in Marketplace and install
  6. +
+

The EAP channel receives every release, giving you the latest features before they hit stable.

+ +

Requirements

+
    +
  • IntelliJ IDEA 2026.2 or newer
  • +
  • JBang CLI installed — or let the plugin install it from SettingsToolsJBang
  • +
+ +

Features

+
    +
  • Multiple JBang roots with isolated classpaths and JDKs
  • +
  • Completion for directives, Maven coordinates, //SOURCES, //FILES, and catalog refs
  • +
  • Run and Debug with gutter icons and run configurations
  • +
  • Per-root //JAVA JDK registration
  • +
  • Diagnostics for invalid directives, unresolved dependencies, and missing resources
  • +
  • Create scripts from templates via NewJBang Script
  • +
+ +

Documentation

+

+ Full documentation · + JetBrains Marketplace · + Source on GitHub

Eclipse

- Eclipse is a popular opensource Java IDE. Has a large ecosystem of plugins and is 100% free to use. + The JBang plugin for Eclipse lets you import and synchronize JBang scripts as projects, with automatic dependency resolution and JDK configuration.

+ +

Install

+

From Eclipse Marketplace:

+
    +
  1. Drag the Install button to your running Eclipse, or:
  2. +
  3. HelpEclipse Marketplace… → search "JBang"Install
  4. +
+ +

Features

+
    +
  • Import JBang scripts as projects (Import Project…JBangJBang script)
  • +
  • Synchronize JBang dependencies to existing projects via right-click
  • +
  • Automatic JDK configuration from //JAVA
  • +
  • Annotation processor detection
  • +
  • Support for //DEPS, //SOURCES, and @Grab
  • +
+ +

Documentation

- JBang is on Eclipse Marketplace + Eclipse Marketplace · + Source on GitHub

Zed

- Zed is a high-performance editor with support for Java using Eclipse JDT Language Server. -

-

- No native JBang support yet, thus simplest way is to use sandbox mode: jbang edit --sandbox --open=zed yourapp.java. + Zed is a high-performance editor with Java support via Eclipse JDT Language Server. + No native JBang plugin yet — use sandbox mode which sets up a temporary project with full classpath:

+
jbang edit --sandbox --open=zed yourapp.java

Vim/neovim

- Vim and neovim are highly configurable text editors built to enable efficient text editing. Supports Java with Eclipse JDT Language Server. -

-

- No native JBang support yet, thus simplest way is to use sandbox mode: jbang edit --sandbox --open=nvim yourapp.java. + Vim and neovim support Java via Eclipse JDT Language Server. + No native JBang plugin yet — use sandbox mode:

+
jbang edit --sandbox --open=nvim yourapp.java

Emacs

- Emacs is an extensible, customizable, free/libre text editor and computing environment. Supports Java with Eclipse JDT Language Server. -

-

- No native JBang support yet, thus simplest way is to use sandbox mode: jbang edit --sandbox --open=emacs yourapp.java. + Emacs supports Java via Eclipse JDT Language Server. + No native JBang plugin yet — use sandbox mode:

+
jbang edit --sandbox --open=emacs yourapp.java
diff --git a/templates/partials/head/custom.html b/templates/partials/head/custom.html index 5b96a35cd..5e6564871 100644 --- a/templates/partials/head/custom.html +++ b/templates/partials/head/custom.html @@ -14,11 +14,11 @@