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.