
Draggable fast scrollbar for lazy lists and grids: single-modifier integration, steady fixed-length thumb, label bubble with haptics, infinite-feed support, customizable appearance, edge-safe behavior.
A draggable fast scrollbar for Jetpack Compose and Compose Multiplatform: LazyColumn, LazyRow and grids. One modifier, no wrapper composable, works on Android, iOS and Desktop.
Status: early (0.x). The full test suite passes on Android devices, Desktop and the iOS simulator.
https://github.com/user-attachments/assets/8f0c4779-44e3-4107-b11b-78473a625502
LazyColumn, LazyRow and lazy grids. No wrapper composable.hasMore, reversed lists, and pages that load mid-drag.contentPadding and RTL.// commonMain, or your app module in a plain Android project
dependencies {
implementation("io.github.amaanprobably:compose-fast-scrollbar:0.1.1")
}Requirements: Compose 1.10 or newer (Compose Multiplatform 1.10.3+), compileSdk 36+, minSdk 24. Targets Android, iOS (iosArm64, iosSimulatorArm64) and Desktop (JVM).
0.x versions: the API may still change between minor versions until 1.0. Breaking changes are listed in the changelog.
Apply the modifier to the lazy layout itself, and pass the same state you give the list:
val listState = rememberLazyListState()
LazyColumn(
state = listState,
modifier = Modifier.scrollbar(listState),
) {
items(1_000) { index -> Text("Item $index") }
}Grids work the same way with a LazyGridState.
Modifier.scrollbar(
listState,
label = ScrollbarLabel { index -> contacts[index].name.take(1) },
)Modifier.scrollbar(listState, hasMore = !endReached)Modifier.scrollbar(
listState,
style = ScrollbarDefaults.style(
thumbAppearance = ThumbAppearance.Icon(
idle = painterResource(Res.drawable.logo),
size = DpSize(40.dp, 40.dp),
),
),
)| Parameter | What it does |
|---|---|
edge |
Which side the bar sits on (ScrollbarEdge.Start or End). |
contentPadding |
The list's padding, so the track stays clear of bars and insets. |
hasMore |
true while more items can load. The thumb stops short of the end. |
style |
The look, sizes, colors, visibility and timings. |
label |
A bubble next to the thumb while dragging. |
Every parameter, with when to use it, is in the guide.
GUIDE.md walks through everything you might want to do, with code and short videos:
Details and workarounds are in Troubleshooting.
ScrollState support (Column with verticalScroll), with exact positionsLazyVerticalStaggeredGrid supportBug reports, feature ideas and support requests are welcome as issues. Pull requests are closed until 1.0. See CONTRIBUTING.md for details and for building the project from source.
Copyright 2026 Amaan Qureshi
Licensed under the Apache License, Version 2.0. You can use this library in any app, commercial or open source. If you redistribute it or a modified version, keep the copyright notice and the NOTICE file.
The demo app's artwork (launcher icon and characters) is licensed separately under CC BY-NC-ND 4.0.
The music in the demo videos is "Lo-Fi Background Lounge" by lsMusic, used under the Pixabay Content License.
A draggable fast scrollbar for Jetpack Compose and Compose Multiplatform: LazyColumn, LazyRow and grids. One modifier, no wrapper composable, works on Android, iOS and Desktop.
Status: early (0.x). The full test suite passes on Android devices, Desktop and the iOS simulator.
https://github.com/user-attachments/assets/8f0c4779-44e3-4107-b11b-78473a625502
LazyColumn, LazyRow and lazy grids. No wrapper composable.hasMore, reversed lists, and pages that load mid-drag.contentPadding and RTL.// commonMain, or your app module in a plain Android project
dependencies {
implementation("io.github.amaanprobably:compose-fast-scrollbar:0.1.1")
}Requirements: Compose 1.10 or newer (Compose Multiplatform 1.10.3+), compileSdk 36+, minSdk 24. Targets Android, iOS (iosArm64, iosSimulatorArm64) and Desktop (JVM).
0.x versions: the API may still change between minor versions until 1.0. Breaking changes are listed in the changelog.
Apply the modifier to the lazy layout itself, and pass the same state you give the list:
val listState = rememberLazyListState()
LazyColumn(
state = listState,
modifier = Modifier.scrollbar(listState),
) {
items(1_000) { index -> Text("Item $index") }
}Grids work the same way with a LazyGridState.
Modifier.scrollbar(
listState,
label = ScrollbarLabel { index -> contacts[index].name.take(1) },
)Modifier.scrollbar(listState, hasMore = !endReached)Modifier.scrollbar(
listState,
style = ScrollbarDefaults.style(
thumbAppearance = ThumbAppearance.Icon(
idle = painterResource(Res.drawable.logo),
size = DpSize(40.dp, 40.dp),
),
),
)| Parameter | What it does |
|---|---|
edge |
Which side the bar sits on (ScrollbarEdge.Start or End). |
contentPadding |
The list's padding, so the track stays clear of bars and insets. |
hasMore |
true while more items can load. The thumb stops short of the end. |
style |
The look, sizes, colors, visibility and timings. |
label |
A bubble next to the thumb while dragging. |
Every parameter, with when to use it, is in the guide.
GUIDE.md walks through everything you might want to do, with code and short videos:
Details and workarounds are in Troubleshooting.
ScrollState support (Column with verticalScroll), with exact positionsLazyVerticalStaggeredGrid supportBug reports, feature ideas and support requests are welcome as issues. Pull requests are closed until 1.0. See CONTRIBUTING.md for details and for building the project from source.
Copyright 2026 Amaan Qureshi
Licensed under the Apache License, Version 2.0. You can use this library in any app, commercial or open source. If you redistribute it or a modified version, keep the copyright notice and the NOTICE file.
The demo app's artwork (launcher icon and characters) is licensed separately under CC BY-NC-ND 4.0.
The music in the demo videos is "Lo-Fi Background Lounge" by lsMusic, used under the Pixabay Content License.