reusable_image_widget

Reusable Flutter widgets and utilities for picking, cropping, compressing, and displaying images with easy configuration.

Features

Pick images from the gallery or camera
Crop images with custom aspect ratio presets
Compress picked images
Display images from assets, files, or network URLs
Fullscreen image viewer with zooming
Circular avatar widgets
Image placeholders and error handling

Installation

Add this to your pubspec.yaml:

reusable_image_widget: <latest_version>

Then run:

flutter pub get

Usage

Pick and Crop Image

final XFile? pickedImage = await pickImage(source: ImageSource.gallery);
if (pickedImage != null) {
  final XFile croppedImage = await cropImage(pickedFile: pickedImage, context: context);
}

Compress Image

final XFile compressedImage = await compressImage(pickedImage);

Display Image

BuildAvatarImage(
  imageSource: 'https://example.com/image.jpg',
)

or from an asset:

BuildAvatarImage(
  imageSource: 'assets/images/profile_pic.jpeg',
)

Use AppCircleAvatar

AppCircleAvatar(
  imageSource: 'https://example.com/profile.jpg',
  radius: 40,
)

Full Screen Viewer

AvatarImageViewer(
  image: pickedFile,
  imageSource: 'https://example.com/image.jpg',
)

Pick Image with Cubit

AppImagePicker(
  onChanged: (file) {
    // Do something with the picked image
  },
)

Show Network Image with Fallback

CachedImage(
  'https://example.com/image.jpg',
  radius: 50,
  isRound: true,
)

Dependencies

flutter
image_picker
image_cropper
flutter_image_compress
cached_network_image
photo_view
flutter_bloc

Example

A complete usage example can be found in the example/ directory.

License

MIT License

Author

reusable_image_widget developed and maintained by Shohidul Islam

Feel free to contribute, open issues, and submit pull requests!