ContactPickerKMP 0.2.0 indexed Enables native contact selection for Android and iOS via a composable component, facilitating easy integration and management of contact permissions and selection states.
Bring this to kpkg
This library is indexed from the KMP ecosystem and already resolves through kpkg.dev's Maven Central proxy. Maintainers can verify the namespace and publish future versions to kpkg for free hosting, real download stats, and signed-provenance pages.
Metadata
Owner dalafiarisamuel
Stars 14
Used by —
Health —
License MIT License
Latest 0.2.0
Repository github.com/dalafiarisamuel/ContactPickerKMP
Updated 2025-10-22 Readme Changelog ContactPicker
ContactPicker is a Kotlin Multiplatform (KMP) library that provides a native contact selection experience for Android and iOS using Jetpack Compose Multiplatform.
Features
Screenshots
Documentation
Full API documentation and guides are available at: https://dalafiarisamuel.github.io/ContactPickerKMP/
Installation
Add the dependency to your commonMain source set in your build.gradle.kts file:
kotlin {
sourceSets {
commonMain.dependencies {
implementation("io.github.dalafiarisamuel:contactpicker:0.2.0" )
}
}
}
Usage
1. Platform Permissions
Before launching the picker, ensure you have declared the necessary permissions.
Android
Add this to your AndroidManifest.xml:
<uses-permission android:name ="android.permission.READ_CONTACTS" />
iOS
Add this to your Info.plist:
<key > NSContactsUsageDescription</key >
<string > Contacts permission is required to access your contacts to help you find friends.</string >
2. Implementation in Compose
Single Selection
Multiple Selection
Contributing
Contributions are welcome! If you find a bug or have a feature request, please open an issue or submit a pull request.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Native Experience : Uses PickContact contract on Android and CNContactPickerViewController on iOS.
Compose Multiplatform : Easy-to-use Composable API with rememberContactPickerState() and rememberMultiContactPickerState().
Multi-Selection Support : Select multiple contacts at once. Supports the native ACTION_PICK_CONTACTS on Android 17 (API 37+) and native CNContactPickerViewController on iOS.
Backward Compatibility : Provides a consistent, custom checkbox-based UI for multi-selection on Android versions prior to API 37.
State Management : Reactive state handling with built-in clear() support to reset selections.
Avatar Support : Retrieve and display contact profile pictures across platforms.
Rich Data : Access names, multiple phone numbers, and email addresses.
Type-Safe : Clean, immutable Contact data model.
import androidx.compose.foundation.Image
import androidx.compose.foundation.layout.*
import androidx.compose.foundation.shape.CircleShape
import androidx.compose.material.*
import androidx.compose.runtime.*
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.draw.clip
import androidx.compose.ui.layout.ContentScale
import androidx.compose.ui.unit.dp
import com.devtamuno.kmp.contactpicker.rememberContactPickerState
import com.devtamuno.kmp.contactpicker.extension.toPlatformImageBitmap
@Composable
fun ContactPickerScreen () val contactPicker = rememberContactPickerState { contact ->
println("Selected: ${contact?.name} " )
}
val contactSelected by contactPicker.value
Column(
modifier = Modifier.fillMaxSize(),
horizontalAlignment = Alignment.CenterHorizontally,
verticalArrangement = Arrangement.Center
) {
Button(onClick = { contactPicker.launchContactPicker() }) {
Text("Pick a Contact" )
}
contactSelected?.let { contact ->
Spacer(modifier = Modifier.height(20. dp))
Text("Name: ${contact.name} " )
contact.contactAvatar?.toPlatformImageBitmap()?.let { imageBitmap ->
Spacer(modifier = Modifier.height(20. dp))
Image(
bitmap = imageBitmap,
contentDescription = "Contact Avatar" ,
contentScale = ContentScale.Crop,
modifier = Modifier.size(100. dp).clip(CircleShape)
)
}
}
Spacer(modifier = Modifier.height(20. dp))
Button(onClick = { contactPicker.clear() }) {
Text("Clear Selection" )
}
}
}
import androidx.compose.foundation.Image
import androidx.compose.foundation.layout.*
import androidx.compose.foundation.lazy.LazyColumn
import androidx.compose.foundation.lazy.items
import androidx.compose.foundation.shape.CircleShape
import androidx.compose.material.*
import androidx.compose.runtime.*
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.draw.clip
import androidx.compose.ui.layout.ContentScale
import androidx.compose.ui.unit.dp
import com.devtamuno.kmp.contactpicker.rememberMultiContactPickerState
import com.devtamuno.kmp.contactpicker.extension.toPlatformImageBitmap
@Composable
fun MultiPickerScreen () val multiContactPicker = rememberMultiContactPickerState { contacts ->
println("Selected ${contacts.size} contacts" )
}
val contactsSelected by multiContactPicker.value
Column(
modifier = Modifier.fillMaxSize().padding(16. dp),
horizontalAlignment = Alignment.CenterHorizontally
) {
Button(onClick = { multiContactPicker.launchContactPicker() }) {
Text("Pick Multiple Contacts" )
}
Spacer(modifier = Modifier.height(16. dp))
Text(
text = "Selected Contacts (${contactsSelected.size} )" ,
style = MaterialTheme.typography.h6
)
Spacer(modifier = Modifier.height(8. dp))
LazyColumn(modifier = Modifier.weight(1f )) {
items(contactsSelected) { contact ->
Row(
modifier = Modifier.fillMaxWidth().padding(vertical = 8. dp),
verticalAlignment = Alignment.CenterVertically
) {
contact.contactAvatar?.toPlatformImageBitmap()?.let { imageBitmap ->
Image(
bitmap = imageBitmap,
contentDescription = "Contact Avatar" ,
contentScale = ContentScale.Crop,
modifier = Modifier.size(40. dp).clip(CircleShape)
)
}
Spacer(modifier = Modifier.width(12. dp))
Text(text = contact.name)
}
}
}
Spacer(modifier = Modifier.height(16. dp))
Button(onClick = { multiContactPicker.clear() }) {
Text("Clear Selection" )
}
}
}
Related libraries Surfaced from shared tags and platforms — no rankings paid for.
KScan ★ 336
ismai117 Enables easy barcode scanning in apps using Google’s MLKit on Android and Apple's AVFoundation on iOS, supporting QR and EAN-13 formats with simple integration. Shared: ui, compose, apple KotlinMultiplatformAuth ★ 82
sunildhiman90 Facilitates multi-platform authentication with Google Sign-In across Android, iOS, Desktop, and Web. Includes GoogleSignInButton composable for easy integration and future support plans for additional providers. Shared: ui, compose, apple compose-shimmer ★ 1.0k
valentinilk Offers shimmering animation for UI elements, integrated via a simple modifier. Includes customization options like theming and animation boundaries. Supports advanced usage scenarios and custom modifiers. Shared: ui, compose JetLime ★ 605
pushpalroy Highly customizable UI library for creating vertical and horizontal timeline views. Supports extended events, various alignment options, custom styles, animations, and dynamic content updates in a timeline format. Shared: ui, compose kaluga ★ 397
splendo Offers modular tools for cross-platform mobile app development, including features like MVVM architecture, location services, permissions management, Bluetooth communication, and more, using coroutines and `Flow` for efficient design. Shared: compose, apple JetCo ★ 375
developerchunk Ready-to-use, customizable Compose UI components — charts, cards, steppers, controls — offering polished visuals, interactive behaviors, performance optimizations, and easy integration into declarative UI projects. Shared: ui, compose 
