[ Documentation ]
peach kotlin

peach kotlin

Runs a foreground preview for an Android app module: its manifest, Gradle files and Kotlin sources, unchanged. The launcher activity cold-starts the way Android starts it and its Compose content renders on an Android device. Sources compile locally with the pinned Kotlin toolchain, which needs a Java runtime; an edit recompiles and restarts the app, as a rebuild does. Gradle values must be literals and dependencies must be in the pinned Compose closure; anything else is rejected with its location. Stop with Ctrl+C to close the owned preview and host.

terminal
peach kotlin <android-app-module> [--activity <name>]

Options

flagdescription
--activity <name>open this activity or alias instead of the launcher, as adb shell am start -n does
--host-port <port>pin the loopback Kotlin preview port; otherwise an available port is selected
--headlesslaunch the owned browser preview without a visible window
--device <model>select the simulated Android device
--driver <playwright|electron>select the existing preview driver
--cdp-port <port>pin the Playwright debugging endpoint

Examples

terminal
peach kotlin ./app