setting-up-compose-hotswan

Installs and configures Compose HotSwan for sub-second hot reload on Android devices.

Updated May 31, 2026
One-click install
npx skills add https://github.com/decoutkhanqindev/Lich-Viet-Loc-Phat --skill setting-up-compose-hotswan-decoutkhanqindev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: setting-up-compose-hotswan
Source: https://github.com/decoutkhanqindev/Lich-Viet-Loc-Phat/tree/main/.claude/skills/setting-up-compose-hotswan
Command: npx skills add https://github.com/decoutkhanqindev/Lich-Viet-Loc-Phat --skill setting-up-compose-hotswan-decoutkhanqindev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up Compose HotSwan involves coordinating a JetBrains IDE plugin, a Gradle compiler plugin, and a specific DSL configuration, and small mistakes like a lowercase DSL name or a missing debugOnly flag silently break hot reload or leak transformations into release builds. ## Core Features & Use Cases - Canonical Gradle wiring: Declares the com.github.skydoves.compose.hotswan.compiler plugin in libs.versions.toml, applies it with apply false at the root, and attaches it only to Compose modules. - Production-safe configuration: Enforces the hotSwanCompiler { enabled = true; debugOnly = true } block so HotSwan transformations never ship in release builds. - End-to-end verification: Walks through the HotSwan tool window flow from READY to WATCHING and confirms the first save-to-reload round-trip with state preservation. - Use Case: A developer who just installed the HotSwan JetBrains Marketplace plugin asks how to wire the Gradle compiler plugin; this Skill produces the three-file paste-ready setup and verifies a body-only edit appears on device in under one second. ## Quick Start Set up Compose HotSwan in my Android project and verify hot reload works on my connected device.

Frequently Asked Questions about setting-up-compose-hotswan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up Compose HotSwan in my Android project?▼

Declare the com.github.skydoves.compose.hotswan.compiler plugin in libs.versions.toml, apply it with apply false in the root build.gradle.kts, then apply it in each Compose module and add the hotSwanCompiler block with enabled = true and debugOnly = true.

How do I enable Compose hot reload on a real device?▼

Install the HotSwan JetBrains Marketplace plugin, wire the Gradle compiler plugin, then open the HotSwan tool window and click Start. Run the app normally; once the status shows WATCHING, saving a body-only edit reloads on device in under one second.

What are the requirements for using Compose HotSwan?▼

You need Android Studio or IntelliJ IDEA 2024.3+, Kotlin 2.0+ with the org.jetbrains.kotlin.plugin.compose plugin applied, Gradle 8+, and a device or emulator visible to adb devices. The HotSwan IDE plugin must be installed from the JetBrains Marketplace.

Why is the HotSwan tool window stuck at READY after running the app?▼

A status stuck at READY means no device is connected to the HotSwan agent. Run adb devices to confirm your device or emulator is listed, then reconnect USB or restart the emulator before launching the app again.

Why does the hotSwanCompiler Gradle block not resolve?▼

The extension is hotSwanCompiler with a capital S; lowercase hotswanCompiler will not resolve. Also re-sync Gradle after adding the plugin and confirm the alias matches the entry in libs.versions.toml with Kotlin 2.0+ active on the module.

Is Compose HotSwan safe to use in release builds?▼

HotSwan transformations are diagnostic-only and must not ship in production. Always set debugOnly = true in the hotSwanCompiler block so release builds exclude the transformations, and never import HotSwan runtime classes in source code.