setting-up-compose-hotswan

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

1|Updated Jul 6, 2026
One-click install
npx skills add https://github.com/citytexi/team-yg-pesonal-agent --skill setting-up-compose-hotswan-citytexi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: setting-up-compose-hotswan
Source: https://github.com/citytexi/team-yg-pesonal-agent/tree/main/.claude/skills/setting-up-compose-hotswan
Command: npx skills add https://github.com/citytexi/team-yg-pesonal-agent --skill setting-up-compose-hotswan-citytexi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up Compose HotSwan involves coordinating a JetBrains IDE plugin, a Gradle compiler plugin, version catalog entries, and a specific DSL block, and small mistakes like a lowercase extension name or a missing debugOnly flag silently break the workflow or leak diagnostic transformations into release builds. ## Core Features & Use Cases - Canonical Gradle wiring: Provides the exact libs.versions.toml plugin declaration, root apply false pattern, and per-module alias(...) application for the com.github.skydoves.compose.hotswan.compiler plugin. - Production-safe configuration: Enforces the hotSwanCompiler { enabled = true; debugOnly = true } DSL 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 preserves navigation, scroll, and remember state. - Use Case: A developer who just installed the HotSwan JetBrains Marketplace plugin asks how to wire the Gradle compiler plugin into an existing Compose project and verify hot reload works on a physical device. ## 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, apply it via alias in each Compose module, and add the hotSwanCompiler block with enabled and debugOnly set to 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 composable edit reloads on device in under one second.

What are the requirements for using Compose HotSwan?▼

HotSwan requires 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 with USB debugging enabled.

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 running app process. Run adb devices to confirm the device or emulator is listed, then reconnect USB or restart the emulator.

Why does my Compose change not hot reload on save?▼

Structural changes such as parameter, constructor, interface, or inline function edits force a rebuild instead of a hot reload. Only body-only edits inside a composable function reload in place; check the hot-reload limits documentation for the exact boundary.

Is it safe to ship Compose HotSwan in release builds?▼

No. HotSwan transformations are diagnostic-only and must not ship in production. Always set debugOnly = true in the hotSwanCompiler block and never import HotSwan runtime classes or annotations in production source code.