unified_file_picker library

Cross-platform file and folder picker with a unified, customizable Flutter UI.

unified_file_picker renders one consistent explorer-style interface on Android, iOS, Windows, Linux, and macOS. Instead of relying on each platform's native dialog, the package provides a fully themeable Flutter experience with list/details/tiles/icons views, recursive search, keyboard shortcuts, and RTL support.

Published by quds.cc.

Getting started

Register the localization delegate in your app:

MaterialApp(
  localizationsDelegates: const [
    UnifiedFilePickerLocalizations.delegate,
    GlobalMaterialLocalizations.delegate,
    GlobalWidgetsLocalizations.delegate,
    GlobalCupertinoLocalizations.delegate,
  ],
  supportedLocales: const [Locale('en'), Locale('ar')],
);

Pick files with the convenience API:

final files = await UnifiedFilePicker.pickFiles(
  context,
  type: FilePickerType.images,
  selection: SelectionMode.multiple,
);

For full control over theme, strings, transitions, and layout, use UnifiedFilePicker.pick with FilePickerOptions:

final result = await UnifiedFilePicker.pick(
  context,
  options: FilePickerOptions(
    theme: FilePickerTheme(title: 'Choose files'),
    initialViewMode: FilePickerViewMode.tiles,
  ),
);

Customization overview

Return values

All pick methods return null when the user cancels. Otherwise they return a non-empty List of PickedFile items. UnifiedFilePicker.saveFile returns a single PickedFile or null.

See also:

• FilePickerScreen, for embedding the picker inside your own navigation.
• showUnifiedFilePickerModal and showUnifiedFilePickerRoute, for low-level presentation control.
• The package README for platform setup and keyboard shortcuts.