setting-up-compose-hotswan

Automate Compose HotSwan setup and verification for sub-second hot reload.

472|16|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/skydoves/compose-performance-skills --skill setting-up-compose-hotswan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: setting-up-compose-hotswan
Source: https://github.com/skydoves/compose-performance-skills/tree/main/hot-reload/setting-up-compose-hotswan
Command: npx skills add https://github.com/skydoves/compose-performance-skills --skill setting-up-compose-hotswan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides you through installing and verifying Compose HotSwan end to end, enabling sub-second hot reload on a real device or emulator in a single session. It covers the JetBrains IDE plugin install, the Gradle plugin wiring, the canonical hotSwanCompiler DSL block with enabled = true and debugOnly = true, the HotSwan tool window flow, and the first save-to-reload verification.

Core Features & Use Cases

  • JetBrains plugin installation and setup for HotSwan.
  • Canonical Gradle wiring with the hotSwanCompiler DSL to enable diagnostic-only hot-reload in development.
  • End-to-end verification workflow using the HotSwan tool window and a first save-to-reload round-trip.

Quick Start

Install the JetBrains plugin, wire the Gradle plugin with hotSwanCompiler { enabled = true; debugOnly = true }, and verify the first save-to-reload cycle on a running app.

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 hot reload on a real Android device?▼

Hot reload in Jetpack Compose allows you to see code changes on a running app without restarting. The HotSwan Gradle plugin uses the hotSwanCompiler DSL to enable diagnostic-only hot-reload, applying saved code changes to the active UI in under a second.

What are the requirements to enable Compose HotSwan in Android Studio?▼

Enabling Compose HotSwan requires Android Studio or IntelliJ 2024.3+, Kotlin 2.0+ with the Compose Kotlin plugin, and Gradle 8+. You must also install the HotSwan plugin in your JetBrains IDE to support the workflow.

How do I configure the hotSwanCompiler block in my Gradle file?▼

Configure the hotSwanCompiler block in your Gradle file by setting enabled = true and debugOnly = true. This canonical Gradle wiring enables diagnostic-only hot-reload capabilities during your development sessions.

Why is my Compose HotSwan save-to-reload verification not working?▼

Save-to-reload verification fails if the HotSwan tool window flow is not followed correctly or if prerequisites are unmet. Ensure you have Kotlin 2.0+ with the Compose Kotlin plugin, Gradle 8+, and JetBrains IDE 2024.3+ before verifying.

Does Compose HotSwan work with IntelliJ and Android Studio?▼

Yes, Compose HotSwan works with IntelliJ and Android Studio. It applies to JetBrains IDE workflows, requiring version 2024.3 or later, and uses a dedicated HotSwan tool window to manage the end-to-end verification process.