relax_image_picker 1.1.0
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
RelaxPickerThemelabels for the banner:limitedAccessLabelandmanageAccessLabel.
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-nullableRelaxPickerResult), 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
acceptedDocumentTypesfiltering 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). RelaxPickerThemefor 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
RelaxPickerResultwithfiles,images,videos, anddocumentslists plusisEmpty/hasMediahelpers. - Media models:
RelaxMediaFile,RelaxImageFile,RelaxVideoFile, andRelaxDocumentFile(with JSON serialization for caching). - Permission handling for Android 13+ scoped storage and iOS limited photo access.
- Android and iOS platform support.
