Skip to content
pubscout

octo_image

2.1.5, released 8 days ago by baseflow.com

A multifunctional Flutter image widget supporting placeholders, error widgets, and fading.

WASM-readyRock solid
$ flutter pub add octo_image
Source repository

What it does

OctoImage is a customizable image widget for Flutter that manages placeholders, progress indicators, error widgets, and image transformations with smooth fading transitions. It uses predefined combinations called OctoSets to simplify loading states.

AI-written summary of version 2.1.3, based on the package's README and metadata. Report an inaccuracy

Use it when

  • You need custom placeholders, progress bars, or error states while loading images.
  • You want smooth fading animations between loading states and loaded images.

Skip it when

  • You only need to display basic local assets without any loading states or transitions.

Strengths

  • Supports placeholders, progress indicators, and error widgets out of the box.
  • Includes reusable OctoSets for common patterns like circle avatars.
  • Provides smooth transitions and image transformers.

Weaknesses

  • Does not handle image caching on its own and requires a separate caching provider like CachedNetworkImage for optimal results.

Setup

Kind
Flutter widgets
Effort
Low
Code generation
No
Direct dependencies
0
OctoImage.fromSet(
  fit: BoxFit.cover,
  image: CachedNetworkImageProvider(
    'https://example.com/image.jpg',
  ),
  octoSet: OctoSet.circleAvatar(
    backgroundColor: Colors.red,
    text: Text("M"),
  ),
);

Alternatives

Packages that do the same job and could replace octo_image.

  • extended_image

    Provides extensive image manipulation features like zooming, panning, and cropping.

Works with

Packages commonly used together with octo_image: ones it builds on, ones built on it, and its own family.