Skip to content
pubscout

flutter_spritesheet_animation

1.3.0, released 2 weeks ago by ravenlab.tech

Lightweight spritesheet animation widget for Flutter with grid and JSON atlas support.

WASM-ready
$ flutter pub add flutter_spritesheet_animation
Source repository

What it does

Renders grid-based and JSON atlas spritesheet animations with support for named frame tags, playback modes, and an external controller. It avoids widget rebuilds by utilizing a CustomPainter and handles optimization through precaching.

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

Use it when

  • You need to render 2D sprite animations or pixel art in your Flutter app or game.
  • You are using TexturePacker or Aseprite JSON exports for sprite atlases.
  • You require fine-grained playback control via an external controller.

Skip it when

  • You need a full-fledged 2D game engine with physics and scene graphs.
  • You are animating vector graphics instead of raster spritesheets.

Strengths

  • Zero external dependencies
  • Zero widget rebuilds during playback by using CustomPainter
  • Supports both uniform grid and JSON atlas (TexturePacker, Aseprite) formats

Weaknesses

  • Limited to sprite sheet animation rendering rather than full game development
  • Requires manual asset management and precaching for optimal loading performance

Setup

Kind
Flutter widgets
Effort
Low
Code generation
No
Direct dependencies
0
SpriteAnimation.grid(
  image: AssetImage('assets/explosion.png'),
  columns: 8,
  rows: 4,
  fps: 24,
  width: 128,
  height: 128,
)

Alternatives

Packages that do the same job and could replace flutter_spritesheet_animation.

  • rive

    Choose Rive if you need interactive, vector-based vector animations with a visual state machine rather than raster spritesheets.

  • lottie

    Choose Lottie if you want to render After Effects animations exported as JSON instead of frame-based sprite sheets.