Gallery picker dialog

Open the native photos and videos picker on Android and iOS

Supported on Android and iOS targets

Android and iOS offer a native interface for users to browse and select photos and videos from their device. FileKit provides a unified API to open the gallery picker dialog on both platforms.

• On Android, FileKit provides the Photo Picker API.
• On iOS, FileKit provides the PHPickerViewController API.

Open the gallery picker

To open the gallery picker dialog on Android and iOS, simply pass Image, Video, or ImageAndVideo to the type parameter:

filekit-dialogs

val image = FileKit.openFilePicker(type = FileKitType.Image)

On iOS, remember FileKit Compose launchers from a stable/root Compose scope, not inside transient surfaces such as ModalBottomSheet, dialogs, popups, or dropdowns. Learn more in GitHub issue #547.

Maximum number of items

On both Android and iOS, you can set a limit on the number of items a user can select by passing the maxItems parameter to FileKitMode.Multiple():

val mode = FileKitMode.Multiple(maxItems = 5)

This limit is natively enforced by the gallery picker UI on both platforms.

For generic file/document pickers, platform APIs generally only support single/multiple selection (without a native max count). In those cases, FileKit still enforces maxItems by truncating returned results.