Documentation
Version Compatibility
HotSwan ships as two artifacts that work together: the IntelliJ plugin (installed in Android Studio or IntelliJ IDEA) and the compiler plugin (applied through Gradle from Maven Central). Kotlin compiler plugins operate on the compiler's intermediate representation, which changes between Kotlin versions, so each HotSwan release supports a specific range of Kotlin versions. Use the map below to pick the right version for your project.
Compatibility map
| IntelliJ plugin | Compiler plugin | Kotlin | IDE |
|---|---|---|---|
| 1.3.5Upcoming | 1.3.5 | 2.4.x | 2025.1+ |
| 1.3.1 – 1.3.4 | 1.3.1 – 1.3.4 | 2.2.x – 2.3.x | 2025.1+ |
| 1.1.2 – 1.3.0 | 1.1.2 – 1.3.0 | 2.3.x | 2025.1+ |
| 1.0.0 – 1.1.1 | 1.0.0 – 1.1.1 | 2.3.x | 2024.3+ |
The Kotlin column is the version of the Kotlin Gradle plugin your project builds with, not the Kotlin version bundled in your IDE. The IDE column is the minimum IntelliJ IDEA / Android Studio platform version the IntelliJ plugin installs on (2025.1 corresponds to Android Studio Narwhal, 2024.3 to Meerkat).
Which version for my Kotlin?
If you start from your project's Kotlin version, this is the HotSwan version you should install:
| Your project | Recommended HotSwan version |
|---|---|
| Kotlin 2.4.x | 1.3.5 or later |
| Kotlin 2.3.x | 1.3.4 (latest 1.3.x) |
| Kotlin 2.2.x | 1.3.4 (requires 1.3.1 or later) |
| Kotlin 2.1.x or older | Not supported, upgrade Kotlin first |
Since 1.3.1, the compiler plugin adapts to the Kotlin compiler version actually resolved on your build classpath instead of binding to a single fixed version, so the same artifact runs cleanly across the supported Kotlin range even when AGP, the Compose compiler plugin, or KSP pull in transitive version differences.
How versioning works
The IntelliJ plugin and the compiler plugin are released in lockstep and share the same version number. Keep them on the same version: the IDE plugin drives compilation and DEX splitting against the bytecode shapes the compiler plugin produces, so mixing versions can lead to reloads being misclassified or silently skipped.
In practice you rarely manage this by hand. The Gradle plugin com.github.skydoves.compose.hotswan.compiler automatically adds the matching client library to your debug build, and the IDE plugin warns when it detects a version mismatch with the project's compiler plugin. See Gradle Configuration for setup details and Requirements for AGP, device, and build-type requirements.
Downloading specific versions
All stable IntelliJ plugin versions can be downloaded from the JetBrains Marketplace stable channel, including older releases if you need to stay on an earlier Kotlin version. What changed in each release is listed on the Releases page.