Release Summary
Compose Hot Reload 1.3.0 is here 🎉
This release is focused on error recovery: when a hot reload leaves your UI in a broken state, Compose Hot Reload detects it, shows an appropriate error message and can recover once you fix the problem in the sources.
Highlights
- Subcompositions error recovery — since CMP 1.13.0, errors thrown in subcompostions are now recoverable
- Hard reset recovery — the application window is recreated to recover from corrupted state after an erroneous reload for Reset UI tools window action (can be used as a fallback for CMP < 1.13.0)
- Richer error reporting — errors thrown in subcompositions are now surfaced
Error Recovery
- Errors thrown in subcompositions after a reload are now reported instead of silently ignored (using the Recomposer error-state API, available since Compose Runtime 1.11.0). Moreover such errors are recoverable since Compose Runtime 1.13.0.
- The new hard reset strategy recreates the application window to recover from state corrupted by an erroneous reload. It is now the default behavior of the Reset UI action; opt out with
-Dcompose.reload.compositionHardResetEnabled=falseto fall back to the lighter reset.
MCP Server
- Screenshots are now captured natively via
ComposeDesktopEntryPoint.captureContentToImage()since CMP 1.13.0, falling back to the previous AWTRobotapproach on older versions — makingtake_screenshotmore accurate and consistent. - Scrollable nodes in the semantic tree now expose
scrollX/scrollYfields describing their scroll state (CMP-10878). - New experimental headless tools:
run_headlesslaunches an app in headless mode starting from a provided composable,close_headlessstops it, andtake_screenshotaccepts asession_idto capture arbitrary screenshots of headless sessions. Opt in withcompose.reload.mcp.headlessToolsEnabled=true.
Dev Tools
- The error overlay and notification now refresh when the error changes after a reload, so the displayed message and stack trace are always up to date.
- Fixed tooltips being rendered behind the error overlay.
Gradle
- Fixed deprecation warnings on Gradle 9.8 (CMP-10862).
Thanks to everyone who filed issues, tested pre-releases, and contributed to this release 🙏