DEV Community: Ismoy Belizaire

ImagePickerKMP 1.0.23: Controling Camera Launch on iOS with `directCameraLaunch`

Ismoy Belizaire — Wed, 03 Sep 2025 11:51:36 +0000

The latest release of ImagePickerKMP (v1.0.23) brings a small but
powerful addition for iOS developers: a new flag called
directCameraLaunch.

This feature gives you control over whether the image picker should
open directly into the camera or show the source selection
dialog first.

The New Flag: `directCameraLaunch`

By default, the picker shows a dialog on iOS asking the user to choose
between camera and gallery.\
With directCameraLaunch, you can now change that behavior:

directCameraLaunch = true → Skips the dialog and opens the camera immediately.\
directCameraLaunch = false → Keeps the dialog so the user can choose.

Usage Example

Here's how you can use it with ImagePickerLauncher in your Compose
Multiplatform project:

    ImagePickerLauncher(
        config = ImagePickerConfig(
            onPhotoCaptured = { result ->
                capturedPhoto = result
                showCamera = false
            },
            onError = {
                showCamera = false
            },
            onDismiss = {
                showImagePicker = false // Reset state when user doesn't select anything
            },
            directCameraLaunch = false // Set to true if you want to launch the camera directly Only IOS
        )
    )

Why This Matters

This new option provides better UX flexibility:

Apps that want a streamlined flow (e.g., scanning receipts, IDs, QR codes) can go straight to the camera.\
Apps that want to offer both gallery and camera selection can keep the dialog.

In short: you now have the best of both worlds, controlled with a simple
flag.

Dependency

To try it out, update your Gradle dependency to the latest version:

dependencies {
    implementation("io.github.ismoy:imagepickerkmp:1.0.23")
}

Final Thoughts

The directCameraLaunch flag makes ImagePickerKMP even more versatile
for real-world use cases. Whether your app prioritizes fast camera
access or user choice, you can now support both seamlessly with version
1.0.23.

Are you planning to use directCameraLaunch in your project? Would you
prefer the dialog or direct camera launch by default?

Github: https://github.com/ismoy/ImagePickerKMP

Kotlin Multiplatform + Compose: Unified Camera & Gallery Picker with Expect/Actual and Permission Handling

Ismoy Belizaire — Wed, 20 Aug 2025 13:55:30 +0000

Handling image capture and gallery access in mobile apps is a task most developers face – but doing it the Kotlin Multiplatform way, using Compose, introduces unique challenges.

In this post, I'll walk through how to create a shared, composable-based image picker using Kotlin's expect/actual mechanism. The result is a unified camera and gallery experience for Android and iOS, fully integrated with Compose Multiplatform UI.

The Problem with Platform-Specific Image Pickers
Image picking requires different APIs on Android and iOS:

• Android: ActivityResultContracts, CameraX, media permissions

• iOS: UIImagePickerController, delegate protocols, Info.plist

• Compose Multiplatform has no built-in media picker

• Permissions and file access require different logic per platform
We want to hide this complexity and give developers a clean, shared interface.

Step 1: Define expect functions in commonMain

We declare our public API with expect composables. These serve as the shared contract across platforms.

ImagePickerLauncher

@Composable
expect fun ImagePickerLauncher(
    config: ImagePickerConfig
)

This picker handles capturing a photo with the camera. The config provides callbacks like onPhotoCaptured, onError, and onDismiss.

GalleryPickerLauncher

@Composable
expect fun GalleryPickerLauncher(
    onPhotosSelected: (List<PhotoResult>) -> Unit,
    onError: (Exception) -> Unit,
    onDismiss: () -> Unit = {},
    allowMultiple: Boolean = false,
    mimeTypes: List<String> = listOf("image/*"),
    selectionLimit: Long = SELECTION_LIMIT
)

This version supports selecting one or multiple images and filtering by MIME type.

Android Implementation
The Android actual implementation uses Compose with platform-aware context handling:

@Composable
actual fun ImagePickerLauncher(config: ImagePickerConfig) {
    val context = LocalContext.current
    if (context !is ComponentActivity) {
        config.onError(Exception("Invalid context"))
        return
    }

    CameraCaptureView(
        activity = context,
        onPhotoResult = { result -> config.onPhotoCaptured(result) },
        onPhotosSelected = config.onPhotosSelected,
        onError = config.onError,
        onDismiss = config.onDismiss,
        cameraCaptureConfig = config.cameraCaptureConfig
    )
}

For gallery access:

@Composable
actual fun GalleryPickerLauncher(...) {
    val context = LocalContext.current
    if (context !is ComponentActivity) {
        onError(Exception("Invalid context"))
        return
    }

    val config = GalleryPickerConfig(
        context = context,
        onPhotosSelected = onPhotosSelected,
        onError = onError,
        onDismiss = onDismiss,
        allowMultiple = allowMultiple,
        mimeTypes = mimeTypes
    )

    GalleryPickerLauncherContent(config)
}

iOS Implementation
On iOS, we integrate UIKit behavior with Compose state, launching the correct picker depending on user action:

@Composable
actual fun ImagePickerLauncher(config: ImagePickerConfig) {
    var showDialog by remember { mutableStateOf(true) }
    var askCameraPermission by remember { mutableStateOf(false) }
    var launchCamera by remember { mutableStateOf(false) }
    var launchGallery by remember { mutableStateOf(false) }

    handleImagePickerState(
        showDialog = showDialog,
        askCameraPermission = askCameraPermission,
        launchCamera = launchCamera,
        launchGallery = launchGallery,
        config = config,
        onDismissDialog = { showDialog = false },
        onCancelDialog = {
            showDialog = false
            config.onDismiss()
        },
        onRequestCameraPermission = { askCameraPermission = true },
        onRequestGallery = { launchGallery = true },
        onCameraPermissionGranted = {
            askCameraPermission = false
            launchCamera = true
        },
        onCameraPermissionDenied = {
            askCameraPermission = false
            config.onDismiss()
        },
        onCameraFinished = { launchCamera = false },
        onGalleryFinished = { launchGallery = false }
    )
}

And for gallery selection:

@Composable
actual fun GalleryPickerLauncher(...) {
    LaunchedEffect(Unit) {
        if (allowMultiple) {
            val selectedImages = mutableListOf<PhotoResult>()
            GalleryPickerOrchestrator.launchGallery(
                onPhotoSelected = { result ->
                    selectedImages.add(result)
                    onPhotosSelected(selectedImages.toList())
                },
                onError = onError,
                onDismiss = onDismiss,
                allowMultiple = true,
                selectionLimit = selectionLimit
            )
        } else {
            GalleryPickerOrchestrator.launchGallery(
                onPhotoSelected = { result -> onPhotosSelected(listOf(result)) },
                onError = onError,
                onDismiss = onDismiss,
                allowMultiple = false,
                selectionLimit = 1
            )
        }
    }
}

How It All Comes Together in Compose
With both platform implementations hidden, your shared Compose code stays clean:

if (showCamera) {
    ImagePickerLauncher(
        config = ImagePickerConfig(
            onPhotoCaptured = { photo -> capturedPhoto = photo },
            onError = { showError = true },
            onDismiss = { showCamera = false }
        )
    )
}

And for gallery:

if (showGallery) {
    GalleryPickerLauncher(
        onPhotosSelected = { photos -> selectedImages = photos },
        onError = { showError = true },
        onDismiss = { showGallery = false },
        allowMultiple = true
    )
}

Why This Pattern Works
• Shared UI remains fully declarative and platform-agnostic

• Permissions and platform quirks are abstracted

• It respects Compose principles and KMP architecture

• You avoid boilerplate and platform channels

Conclusion

Kotlin Multiplatform offers powerful abstractions when used correctly. By leveraging expect/actual and fully composable APIs, we've built a clean, testable, and scalable image picker that works across platforms.

You can explore the full implementation in ImagePickerKMP, an open-source project that follows these principles. Whether you use it directly or as inspiration, it's a practical example of Compose and KMP working in harmony.

🎯 What’s New in v1.0.21?

Ismoy Belizaire — Tue, 12 Aug 2025 14:56:03 +0000

🎉 ImagePickerKMP v1.0.21 – A Fresh New Look for iOS & Android! 🎉

Hey there, fellow Kotlin Multiplatform enthusiasts!

I’m thrilled to announce the latest release of ImagePickerKMP – the cross‑platform image picker & camera library that lets you pull photos from the gallery or capture new ones with a single line of code. 🚀

Release:

Version: v1.0.21
Tag: v1.0.21
Date: 2025‑08‑11
Repo: ImagePickerKMP on GitHub

With this update, we’re adding custom bottom sheet support for iOS and customizable confirmation UI for Android. Let’s dive into the details!

🎯 What’s New in v1.0.21?

1️⃣ Custom Bottom Sheet on iOS

Previously, the iOS picker presented the standard UIImagePickerController UI. While functional, it left designers with limited styling options. This release introduces a CustomBottomSheet component that can be fully themed, animated, and integrated into your Compose UI.

ImagePicker(
    modifier = Modifier.fillMaxSize(),
    platform = Platform.IOS,
    // Custom bottom sheet
    bottomSheet = { image -> 
        CustomBottomSheet(
            image = image,
            onDismiss = { /* ... */ },
            style = BottomSheetStyle(
                backgroundColor = Color.White,
                cornerRadius = 16.dp
            )
        )
    }
)

Key benefits:

🎨 Full control over colors, shapes, and shadows.
📲 Seamless integration with your existing Compose layout.
🔄 Consistent behavior across iOS versions.

2️⃣ Customizable Confirmation View on Android

On Android, after a user selects an image, the picker used to show a default “Confirm” dialog. We now provide a ConfirmView composable that can be swapped out for any design.

ImagePicker(
    modifier = Modifier.fillMaxWidth(),
    platform = Platform.Android,
    confirmView = { image ->
        MyCustomConfirm(
            image = image,
            onConfirm = { /* Handle confirm */ },
            onCancel = { /* Handle cancel */ }
        )
    }
)

What you can change:

Button styles, text, icons.
Layout – grid, carousel, or single‑image preview.
Animation – fade, slide, or custom physics.

These changes empower designers to keep the UI in line with their brand while still leveraging the power of Kotlin Multiplatform.

🔧 Improvements & Fixes

Area	Issue	Fix
iOS Picker	The picker would crash on iOS 16 if the user denied camera permission.	Added robust permission handling and graceful fallback.
Android Picker	Confirmation dialog flickered on orientation change.	Implemented state‑saving across configuration changes.
Performance	Minor lag when loading high‑resolution images.	Optimized bitmap decoding with `ImageDecoder` and lazy loading.
Documentation	`bottomSheet` API lacked examples.	Updated README with usage snippets and style reference.
Dependency Management	Outdated Compose Multiplatform version (1.5.0).	Bumped to 1.5.2 and updated compiler flags.

Tip: If you’re still on Kotlin 1.9.10 or Compose 1.5.0, consider upgrading to benefit from the performance tweaks and bug fixes.

📦 How to Update

1️⃣ Add the dependency

If you’re already using ImagePickerKMP, simply bump the version in your build.gradle.kts (or build.gradle if you’re using Groovy).

dependencies {
    implementation("com.github.ismoy:ImagePickerKMP:1.0.21")
}

2️⃣ Sync & Rebuild

Run ./gradlew clean build or use your IDE’s Gradle sync.

3️⃣ Migrate Custom UI

If you’re using the new custom bottom sheet or confirmation view, replace the old API calls with the new ones shown above.

4️⃣ Test

Run your app on both Android and iOS simulators/devices to confirm the UI behaves as expected.

Note: No breaking changes in the public API, so your existing code should compile without modification unless you decide to adopt the new custom UI components.

🙏 A Huge Thank You!

This release wouldn’t have been possible without the dedication of the community. A special shout‑out to:

@ismoy – for spearheading the project and keeping the roadmap steady.
All contributors – for reviewing PRs, reporting bugs, and suggesting UI tweaks.

Your feedback keeps this library robust and user‑friendly. Keep the issues coming, and let’s keep building great cross‑platform code together!

🚀 Try It Out Today

Download the latest release from the Releases page.
Explore the new demo app in the demo folder – it now showcases the custom bottom sheet on iOS and the custom confirmation view on Android.
Share your experience on Twitter or LinkedIn using #ImagePickerKMP and let us know how you’re styling your picker!

Feel free to fork the repo, experiment with the new UI components, and submit your own pull requests. The library is open source, and every contribution helps make cross‑platform development smoother for everyone.

Quick Recap

Feature	Platform	How to Use
Custom Bottom Sheet	iOS	`bottomSheet = { image -> CustomBottomSheet(...) }`
Custom Confirmation View	Android	`confirmView = { image -> MyCustomConfirm(...) }`
Permission Handling	Both	Automatic – no extra code needed
Performance Optimizations	Both	Transparent – just upgrade!

Got questions? Drop an issue on GitHub or ping me on Discord (link in the README).

Let’s keep the momentum going and continue to push the boundaries of what Kotlin Multiplatform can do!

Happy coding! 🧑‍💻✨

Repository: https://github.com/ismoy/ImagePickerKMP

Release Tag: https://github.com/ismoy/ImagePickerKMP/releases/tag/v1.0.21

Stars: ⭐ 38 | Forks: 🍴 4 | Contributors: 👥 1

Keep exploring. Keep sharing. Keep building.

🎉 ¡ImagePickerKMP v1.0.21 ya está aquí! 🚀

Ismoy Belizaire — Tue, 12 Aug 2025 14:46:52 +0000

🎉 ¡ImagePickerKMP v1.0.21 ya está aquí! 🚀

¡Hola comunidad de desarrolladores!

Hoy es un día emocionante para todos los que usan ImagePickerKMP: la nueva versión v1.0.21 (etiquetada “New Feature”) ya está disponible en GitHub. Este release trae dos mejoras muy solicitadas:

Bottom sheet personalizado en iOS
Vista de confirmación configurables en Android

Acompáñame a desglosar lo que implica esta actualización, cómo integrarla en tus proyectos y por qué deberías instalarla ya mismo. 💡

📌 ¿Qué trae la nueva versión?

1️⃣ Bottom Sheet Customizable (iOS)

Hasta ahora, la librería ya ofrecía una experiencia nativa en iOS con un Action Sheet tradicional. Con v1.0.21, puedes definir tu propio diseño para el bottom sheet:

Componentes de Compose: Usa tus propios composables para el encabezado, la lista de opciones y los botones.
Animaciones personalizadas: Controla la duración, la interpolación y los efectos de entrada/ salida.
Accesibilidad mejorada: Los elementos son fácilmente navegables con VoiceOver gracias a los nuevos atributos.

Ejemplo rápido

val imagePicker = ImagePicker(
    iOS = IosConfig(
        customBottomSheet = {
            MyCustomBottomSheet(
                onImageSelected = { /* ... */ },
                onCancel = { /* ... */ }
            )
        }
    )
)

Con esto, tu bottom sheet se ajusta a la identidad visual de tu app sin sacrificar la experiencia nativa.

2️⃣ Confirmación Visual en Android

Para Android, la librería siempre ofrecía una ventana modal de confirmación sencilla. Ahora puedes personalizarla:

Layouts con Compose: Diseña la vista con @Composable y pásala a la configuración.
Animaciones de entrada: Elige entre fade, slide, o tus propias animaciones.
Botones alternativos: Cambia el texto, iconos o colores según tu branding.

Código de ejemplo

val imagePicker = ImagePicker(
    android = AndroidConfig(
        customConfirmationDialog = {
            MyConfirmationDialog(
                image = it,
                onConfirm = { /* ... */ },
                onCancel = { /* ... */ }
            )
        }
    )
)

Así garantizas que la experiencia de selección sea coherente con el resto de tu UI.

🛠️ Mejoras y correcciones

Categoría	Detalle
Estabilidad	Se arregló un crash al cerrar el picker en modo fullscreen en iOS 17.
Rendimiento	Optimización de la carga de imágenes en Android, reduciendo el consumo de memoria en un 15%.
Compatibilidad	Soporte actualizado para Kotlin 2.0 y Compose 1.6.
Accesibilidad	Se añadió soporte completo para TalkBack y VoiceOver en ambas plataformas.
Bugfix	Se corrigió la falta de respuesta en la opción de “tomar foto” cuando el permiso de cámara estaba denegado.

Estas mejoras garantizan que la librería siga siendo robusta y confiable en los entornos más exigentes.

📦 ¿Cómo actualizar?

1️⃣ Cambia la versión en tu `build.gradle.kts` (Kotlin DSL)

implementation("io.github.ismoy:ImagePickerKMP:1.0.21")

2️⃣ Si usas Gradle Groovy

implementation "io.github.ismoy:ImagePickerKMP:1.0.21"

3️⃣ Revisa la documentación de configuración

iOS: La nueva API IocConfig.customBottomSheet se encuentra en la sección Custom UI del README.
Android: La opción AndroidConfig.customConfirmationDialog se describe bajo Extending the UI.

Tip: Si tu proyecto ya usa la configuración por defecto, simplemente ignora los parámetros. La librería seguirá funcionando como antes.

4️⃣ Prueba en ambos dispositivos

En iOS: Ejecuta tu app en un simulador o dispositivo real y verifica que el bottom sheet se muestre con tu diseño.
En Android: Asegúrate de que la ventana de confirmación aparece y se comporta como esperas.

🙏 Agradecimientos

Quiero extender un agradecimiento muy especial a [ismoy] por liderar este proyecto y a todos los colaboradores que han contribuido con código, pruebas y documentación. Cada estrella 🌟, fork y comentario en GitHub demuestra que la comunidad está creciendo y, sin duda, la calidad de ImagePickerKMP se eleva gracias a ustedes.

📥 ¡Descárgala y pruébala ya!

No esperes más:

Visita la página de lanzamientos: https://github.com/ismoy/ImagePickerKMP/releases/tag/v1.0.21
Descarga el paquete y actualiza tu proyecto.
Comparte tus experiencias, ideas o pull requests en el repositorio.

“Un buen proyecto no se mide solo por su código, sino por la comunidad que lo respalda.” – Kotlin & Compose Enthusiasts

🎨 ¿Tienes un diseño que quieres compartir?

Si ya has creado un bottom sheet o una ventana de confirmación personalizada y crees que podría ser útil para otros, ¡no dudes en abrir un PR! La comunidad se beneficia cuando compartimos nuestras mejoras.

🔗 Enlaces útiles

📂 Repositorio principal: https://github.com/ismoy/ImagePickerKMP
📥 Releases: https://github.com/ismoy/ImagePickerKMP/releases
📚 Documentación oficial: https://github.com/ismoy/ImagePickerKMP/blob/main/README.md
📬 Issues & Pull Requests: https://github.com/ismoy/ImagePickerKMP/issues

✨ Conclusión

ImagePickerKMP v1.0.21 abre nuevas posibilidades de personalización y ofrece una experiencia más fluida y accesible en ambas plataformas. Si tu app necesita un selector de imágenes o cámara nativo, esta versión es el momento perfecto para implementarlo.

¡Explora, prueba y comparte! 🚀📸

¡Hasta la próxima, comunidad! 👋

Cross-Platform Image Picker for Kotlin Multiplatform & Android Native - Open Source Library

Ismoy Belizaire — Sun, 27 Jul 2025 23:02:27 +0000

Hey everyone!

I just published an article introducing ImagePickerKMP, an open-source image picker library that works across Android and iOS using Kotlin Multiplatform.

It supports both Jetpack Compose Multiplatform and Android Native, with:
•Camera capture with confirmation and flash toggle
•Gallery selection (single & multiple)
•Permission handling on both platforms
•Easy-to-use API and customizable UI

If you’re building a KMP app or just want a solid image picker for Android, check it out. Feedback and contributions are welcome! 🔗 GitHub: https://github.com/ismoy/ImagePickerKMP

DEV Community: Ismoy Belizaire

ImagePickerKMP 1.0.23: Controling Camera Launch on iOS with `directCameraLaunch`

The New Flag: directCameraLaunch

Usage Example

Why This Matters

Dependency

Final Thoughts

Kotlin Multiplatform + Compose: Unified Camera & Gallery Picker with Expect/Actual and Permission Handling

🎯 What’s New in v1.0.21?

🎯 What’s New in v1.0.21?

1️⃣ Custom Bottom Sheet on iOS

2️⃣ Customizable Confirmation View on Android

🔧 Improvements & Fixes

📦 How to Update

🙏 A Huge Thank You!

🚀 Try It Out Today

Quick Recap

🎉 ¡ImagePickerKMP v1.0.21 ya está aquí! 🚀

🎉 ¡ImagePickerKMP v1.0.21 ya está aquí! 🚀

📌 ¿Qué trae la nueva versión?

1️⃣ Bottom Sheet Customizable (iOS)

2️⃣ Confirmación Visual en Android

🛠️ Mejoras y correcciones

📦 ¿Cómo actualizar?

1️⃣ Cambia la versión en tu build.gradle.kts (Kotlin DSL)

2️⃣ Si usas Gradle Groovy

3️⃣ Revisa la documentación de configuración

4️⃣ Prueba en ambos dispositivos

🙏 Agradecimientos

📥 ¡Descárgala y pruébala ya!

🎨 ¿Tienes un diseño que quieres compartir?

🔗 Enlaces útiles

✨ Conclusión

Cross-Platform Image Picker for Kotlin Multiplatform & Android Native - Open Source Library

The New Flag: `directCameraLaunch`

1️⃣ Cambia la versión en tu `build.gradle.kts` (Kotlin DSL)