Lightweight radial/circular menu with long-press, right-click and keyboard triggers; drag-to-select, edge-aware placement, haptics, animated transitions, badges, toggleable icon states, customizable animations.
A lightweight Kotlin Multiplatform radial context menu library for Android and Desktop JVM.
RadialMenu supports Compose APIs (RadialMenuWrapper + RadialMenuOverlay) and Android View APIs (RadialMenuView), with trigger modes for long press, right click, and keyboard hold interactions.
| RadialMenu | Kotlin | Compose Multiplatform | AGP | Android Min SDK | Desktop Min JDK |
|---|---|---|---|---|---|
| 1.0.5 |
RadialMenu follows Semantic Versioning.
Minor versions add features without breaking public API; major versions may include breaking changes (see CHANGELOG.md).
| Platform | Status |
|---|---|
| Android (Compose + View) | Supported |
| Desktop JVM (Compose) | Supported |
Full docs: gawwr4v.github.io/RadialMenu
dependencies {
implementation("io.github.gawwr4v:radialmenu:1.0.5")
}
// app/build.gradle.kts
dependencies {
implementation("io.github.gawwr4v:radialmenu:1.0.5")
// Required only if you use the Painter-based item constructor directly.
// Not required when using DrawableRes/Drawable overloads.
implementation("androidx.compose.ui:ui:1.8.0")
}
// app/build.gradle.kts
plugins {
id("org.jetbrains.kotlin.plugin.compose") version "2.1.0"
}
android {
buildFeatures {
compose = true
}
}
dependencies {
implementation("io.github.gawwr4v:radialmenu:1.0.5")
implementation("androidx.compose.ui:ui:1.8.0")
implementation("androidx.compose.material3:material3:1.3.0")
implementation("androidx.activity:activity-compose:1.9.0")
}
dependencies {
implementation("io.github.gawwr4v:radialmenu:1.0.5")
implementation(compose.desktop.currentOs)
}
Desktop minimum runtime: Java 17.
import io.github.gawwr4v.radialmenu.*
val items = listOf(
RadialMenuItem(id = 1, icon = sharePainter, label = "Share"),
RadialMenuItem(id = 2, icon = likePainter, label = "Like"),
RadialMenuItem(id = 3, icon = savePainter, label = "Save")
)
Box {
RadialMenuWrapper(
items = items,
onItemSelected = { item -> handleSelection(item) }
) {
Content()
}
RadialMenuOverlay(items = items)
}
RadialMenuWrapper supports:
RadialMenuTriggerMode.Auto (default)RadialMenuTriggerMode.LongPress(positionAware = true)RadialMenuTriggerMode.SecondaryClick(positionAware = false)RadialMenuTriggerMode.KeyboardHold(key = Key.Q)Auto resolves to:
LongPress(positionAware = true)SecondaryClick(positionAware = false)KeyboardHold behavior:
val radialMenu = findViewById<RadialMenuView>(R.id.radialMenu)
val items = listOf(
RadialMenuItem(context = this, id = 1, iconRes = R.drawable.ic_share, label = "Share"),
RadialMenuItem(context = this, id = 2, iconRes = R.drawable.ic_like, label = "Like"),
RadialMenuItem(context = this, id = 3, iconRes = R.drawable.ic_save, label = "Save")
)
radialMenu.setItems(items)
radialMenu.enableEdgeHugLayout = true
radialMenu.triggerMode = RadialMenuTriggerMode.LongPress(positionAware = )
radialMenu.onItemSelected = { item -> handleSelection(item) }
RadialMenuViewsupportsLongPressandSecondaryClick.
KeyboardHoldis accepted for API symmetry but not implemented in the View system.
Default API:
RadialMenuItem(id = 1, icon = painter, label = "Share")
Android resource overload:
RadialMenuItem(context = this, id = 1, iconRes = R.drawable.ic_share, label = "Share")
Android drawable overload:
RadialMenuItem(id = 1, icon = drawable, label = "Share")
Desktop uses Painter icons.
Edge-hug is opt-in:
RadialMenuWrapper(
items = items,
onItemSelected = { /* ... */ },
enableEdgeHugLayout = true
) { Content() }
When the menu opens in a true corner with 4+ items, RadialMenu can switch to corner-aware edge-hug placement.
For center-spawned keyboard menus, edge-hug is automatically bypassed.
4-8 items.8 items for touch ergonomics.Symptom: Unresolved reference: RadialMenuView.
Fix:
implementation("io.github.gawwr4v:radialmenu:1.0.5@aar")
Verify with:
./gradlew :app:dependencies
./gradlew :app:dependencyInsight --dependency radialmenu --configuration releaseRuntimeClasspath
Symptom: class file version 65.0.
Cause: pre-1.0.5 artifact on Java 17 runtime.
Fix: upgrade to 1.0.5 or run Java 21+ for older artifacts.
Painter in View-only integrationFix option 1:
implementation("androidx.compose.ui:ui:1.8.0")
Fix option 2: use iconRes/Drawable overloads instead of direct Painter.
Auto: long press on Android, right click on Desktop.radialmenu, radialmenu-android, and .KeyboardHold is Compose-only; supports and .Apache License 2.0. See LICENSE.
Developers often discover RadialMenu through searches like:
| 2.1.20 |
| 1.7+ |
| 8.5+ |
| 21 |
| 17 |
RadialMenuTriggerMode.Auto.LongPress, SecondaryClick, KeyboardHold(key).badgeCount and badgeText).kotlin-stdlib (consumer provides Compose/AndroidX).| Feature | RadialMenu | Typical Android-only alternatives |
|---|
| Android + Desktop JVM | Yes | Usually Android only |
| Kotlin Multiplatform | Yes | Usually no |
| Compose + View API mix | Yes | Usually one UI stack |
| Trigger modes | Auto / LongPress / SecondaryClick / KeyboardHold | Usually long press only |
| Edge-aware corner strategy | Yes | Often missing |
| Maven Central publish | Yes | Often JitPack-only |
radialmenu-desktopkotlin-stdlib only).RadialMenuViewLongPressSecondaryClick4-8 items; more is supported but less ergonomic on small touch screens.Painter constructors directly in View-only modules, add androidx.compose.ui:ui (or use iconRes/Drawable overloads).Surfaced from shared tags and platforms — no rankings paid for.