any_image

Flutter never gave us a universal <img> tag. any_image does.

A universal Flutter image widget that automatically resolves and renders network, asset, and SVG images from a single source string. Designed to be extended, not modified.

pub.dev License: MIT Platform

The problem

Flutter gives you Image.network, Image.asset, SvgPicture.network, SvgPicture.asset — and expects you to know which one to use before rendering. In real apps, image sources arrive as opaque strings from APIs, CMSes, or databases. You shouldn't have to inspect the source to render it.

any_image handles that decision for you.

Installation

dependencies:
  any_image: ^0.0.1

flutter pub get

Usage

Basic

import 'package:any_image/any_image.dart';

// Network raster
AnyImage(source: 'https://example.com/photo.jpg')

// Network SVG
AnyImage(source: 'https://example.com/logo.svg')

// Asset raster
AnyImage(source: 'assets/images/banner.png')

// Asset SVG
AnyImage(source: 'assets/icons/logo.svg')

That's it. any_image resolves the type and renders the correct widget automatically.

With options

AnyImage(
  source: imageUrl,
  width: 200,
  height: 200,
  fit: BoxFit.cover,
  placeholder: const CircularProgressIndicator(),
  errorWidget: const Icon(Icons.broken_image),
)

Override resolution

For sources where auto-resolution cannot determine the format (e.g. CDN URLs with no extension), use the format override:

AnyImage(
  source: 'https://cdn.example.com/a8f3k',
  format: ImageFormat.svg,
)

How it works

any_image runs an ordered resolver pipeline on the source string:

  1. PrefixResolver — detects assets/, http://, https://
  2. ExtensionResolver — detects .svg, .png, .jpg, .webp, .gif

The resolved location and format are merged, then dispatched to the correct renderer:

Location Format Renderer
network raster CachedNetworkImage
network svg SvgPicture.network
asset raster Image.asset
asset svg SvgPicture.asset

any_image does not reimplement image rendering — it composes on top of cached_network_image and flutter_svg.

Platform support

Android iOS Web macOS Windows Linux
✅ ✅ ✅ ✅ ✅ ✅

Roadmap

  • File image support (Image.file, SvgPicture.file)
  • Global defaults via AnyImageTheme
  • Custom renderer registry via AnyImage.configure()
  • Builder API for custom loading states
  • Fallback chained source support

Contributing

Contributions are welcome. Please read CONTRIBUTING.md before opening a pull request.

License

MIT © Sameer Ankalagi

Libraries

any_image