Imago #

A powerful and flexible image widget for Flutter applications with support for network images, local assets, and file images.

Features #

• 🖼️ Multiple Image Types: Support for network images, local SVG assets, local image assets, and file images
• 🚀 Built-in Caching: Automatic caching for network images using cached_network_image
• 🎨 Customizable Placeholders: Custom placeholder widgets and error handling
• 🛡️ Error Handling: Graceful error handling with customizable error widgets

Assets Structure #

Place your assets in these directories for automatic path resolution:

• SVG files: assets/svg/ (e.g., assets/svg/icons/icon.svg)
• Image files: assets/images/ (e.g., assets/images/logos/logo.png)
• Default placeholder: assets/images/placeholders/placeholder.png (optional - uses icon fallback if not found)

Imago automatically resolves paths:

• Imago.localSvg('icons/icon') → assets/svg/icons/icon.svg
• Imago.localImage('logos/logo') → assets/images/logos/logo.png

Factory Methods #

Imago.of() - Remote with Fallback

Imago.of(
  remoteUrl: 'https://example.com/image.jpg',
  localFallback: 'placeholder',
  localFallbackType: ImageType.localImage,
  width: 200,
  height: 200,
)

Imago.localSvg() - SVG Assets

Imago.localSvg(
  'icon_name',
  size: 24,
  color: Colors.blue,
)

Imago.localImage() - Image Assets

Imago.localImage(
  'image_name',
  width: 100,
  height: 100,
  fit: BoxFit.cover,
)

Imago.file() - File Images

Imago.file(
  '/path/to/image.jpg',
  width: 200,
  height: 200,
)

Customization Options #

Imago(
  'https://example.com/image.jpg',
  width: 200,
  height: 200,
  fit: BoxFit.cover,
  borderRadius: BorderRadius.circular(10),
  color: Colors.blue,
  colorBlendMode: BlendMode.overlay,
  placeholder: 'assets/images/placeholders/placeholder.png',
  showProgressIndicator: true,
  shrinkOnError: false,
  shrinkOnLoading: false,
  fadeInDuration: Duration(milliseconds: 500),
  fadeOutDuration: Duration(milliseconds: 1000),
  httpHeaders: {'Authorization': 'Bearer token'},
  cacheKey: 'unique_cache_key',
  memCacheWidth: 300,
  memCacheHeight: 300,
)

Default Placeholder #

Imago now uses an icon-based placeholder by default (Icons.image_outlined) instead of requiring a placeholder image asset. This provides:

API Reference #

Imago Constructor #

ImageType Enum #

• ImageType.networkImage - Network image loaded from URL
• ImageType.localSvg - Local SVG asset
• ImageType.localImage - Local image asset (PNG, JPG, etc.)
• ImageType.file - File from device storage

Dependencies #

• cached_network_image: ^3.3.1 - For network image caching
• flutter_svg: ^2.0.10+1 - For SVG support

Contributing #

Contributions are welcome! Please feel free to submit a Pull Request.

License #

This project is licensed under the MIT License - see the LICENSE file for details.

Support #

If you encounter any issues or have questions, please file an issue on the GitHub repository.