relax_image_picker 1.1.0 copy "relax_image_picker: ^1.1.0" to clipboard
relax_image_picker: ^1.1.0 copied to clipboard

A powerful, WhatsApp-like media picker for Flutter

Changelog #

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

1.1.0 - 2026-06-30 #

Added #

  • Partial ("Selected photos") media access support for Android 14+ and iOS 14+: when the user grants access to only a subset of their library, the gallery now shows a banner with a Manage action that re-opens the system selector (PhotoManager.presentLimited) so they can widen the selection, then reloads the grid.
  • Two customizable RelaxPickerTheme labels for the banner: limitedAccessLabel and manageAccessLabel.

Changed #

  • Documented Google Play's Photo and Video Permissions policy in the README, including a ready-to-paste declaration justification, the partial-access requirement, and a tools:node="remove" snippet for stripping unwanted transitive media permissions.

1.0.1 - 2026-06-16 #

Added #

  • Screenshots showcasing the default and custom themes, surfaced in the README and the pub.dev gallery.

Changed #

  • Rewrote the README: documented theming and widget-slot builders, corrected the pick() return type (non-nullable RelaxPickerResult), and expanded the platform setup with minimal permission sets and store-review guidance.

1.0.0 - 2026-06-16 #

Initial release.

Added #

  • WhatsApp-style media picker presented as a single bottom sheet.
  • Gallery browsing with album selection and paginated, lazily-loaded media.
  • In-picker camera for capturing photos and videos.
  • Document selection from device storage, with optional acceptedDocumentTypes filtering and recall of recently picked documents between sessions.
  • Full-screen preview step for images, videos, and documents before confirming.
  • Optional on-the-fly image compression (enableCompression).
  • Configurable selection limit (maxSelection) and per-type toggles (allowImages, allowVideos, allowDocuments, enableCamera, enablePreview).
  • RelaxPickerTheme for full UI customization: accent color, surfaces and shapes, text and button styles, icons, and labels.
  • Widget-slot builders to fully replace individual UI elements (send button, tabs, media/document/camera tiles, empty states, bottom bar, capture button).
  • Typed results via RelaxPickerResult with files, images, videos, and documents lists plus isEmpty / hasMedia helpers.
  • Media models: RelaxMediaFile, RelaxImageFile, RelaxVideoFile, and RelaxDocumentFile (with JSON serialization for caching).
  • Permission handling for Android 13+ scoped storage and iOS limited photo access.
  • Android and iOS platform support.
2
likes
160
points
92
downloads
screenshot

Documentation

API reference

Publisher

unverified uploader

Weekly Downloads

A powerful, WhatsApp-like media picker for Flutter

Repository (GitHub)
View/report issues
Contributing

License

MIT (license)

Dependencies

camera, file_picker, flutter, flutter_image_compress, path_provider, pdfx, permission_handler, photo_manager

More

Packages that depend on relax_image_picker