English | 中文

A Compose Multiplatform library that ports the contact_list_view Flutter package. It provides an A-Z grouped contact list with sticky section headers, a right-side alphabet index bar, and a floating cursor while dragging.

Repository: github.com/Matkurban/ContactListView

ScreenShot	ScreenShot

• A-Z grouping — groups contacts by tag with # sorted last
• Sticky section headers — optional pinned overlay header while scrolling
• Alphabet index bar — tap or drag to jump between sections
• Floating cursor — letter indicator shown while dragging the index bar
• Custom builders — stickyHeaderBuilder, cursorBuilder, index bar style builders
• startContent / endContent — leading and trailing lazy list slots
• 100% commonMain — single shared source set for all platforms

Add to your gradle/libs.versions.toml:

[versions]
contactlistview = "1.0.0"

[libraries]
contactlistview = { module = "io.github.matkurban:contactlistview", version.ref = "contactlistview" }

Then in build.gradle.kts:

kotlin {
    sourceSets {
        commonMain.dependencies {
            implementation(libs.contactlistview)
        }
    }
}

Alternatively, add the dependency directly to your commonMain source set:

// build.gradle.kts
kotlin {
    sourceSets {
        commonMain.dependencies {
            implementation("io.github.matkurban:contactlistview:1.0.0")
        }
    }
}

Import from io.github.matkurban.contactlistview.*.

import androidx.compose.material3.ListItem
import androidx.compose.material3.Text
import io.github.matkurban.contactlistview.ContactListView

data class Contact(val name: String)

ContactListView(
    contactsList = contacts,
    tag = { contact ->
        val first = contact.name.firstOrNull()?.uppercaseChar() ?: '#'
        if (first in 'A'..'Z') first.toString() else "#"
    },
    sticky = true,
    startContent = {
        item { ListItem(headlineContent = { Text("New friends") }) }
    },
    endContent = {
        item { ListItem(headlineContent = { Text("Total ${contacts.size} contacts") }) }
    },
    itemBuilder = { contact ->
        ListItem(headlineContent = { Text(contact.name) })
    },
)

This repository includes demo apps for each platform:

Run the samples:

./gradlew :androidApp:assembleDebug
./gradlew :desktopApp:run
./gradlew :webApp:wasmJsBrowserDevelopmentRun
./gradlew :contactlistview:jvmTest

• Kotlin 2.4.0+
• Compose Multiplatform 1.11.1+
• JDK 17+

• contactlistview — published library (100% commonMain)
• sample — demo UI (not published)
• androidApp / desktopApp / webApp — sample apps

• Original Flutter package

This project is licensed under the MIT License.