flutter_spritesheet_animation
Lightweight spritesheet animation widget for Flutter. Grid-based and JSON atlas (TexturePacker, Aseprite) support with named animations, playback modes, and external controller.
1.0.3
19K downloads/mo
#2239 most downloaded on pub.dev
erykkruk/flutter_spritesheet_animation
What this package is like to depend on
Last release 2 months ago
07 Jun 2026
Ships on a steady schedule
a new release about every 4 weeks
Nearly every release is documented
notes for 4 of 4 stable releases
Nothing withdrawn
no release was ever pulled
4 months old
4 releases · first in 2026
4 releases in the last 12 months
see the full history below
Release timeline
4 releases · Apr 2026 to Jun 2026Releases
latest 4-
1.0.307 Jun 2026Release notes
Open source →- Added
PlayModeXextension withisForward,isReverseandisPingPongconvenience getters onPlayMode.
- Added
-
1.0.213 May 2026Release notes
Open source →SpriteAnimationControllerconstructor now validatesfpsimmediately (throwsArgumentErrorwhenfps <= 0). Previously the assertion only ran when callers later mutatedfpsthrough the setter.- Extracted hot-loop magic numbers into named constants
(
_kMicrosecondsPerSecond,_kMicrosecondsPerMillisecond) inside the tick accumulator — no behavioural change, just readability.
-
1.0.113 Apr 2026 -
1.0.013 Apr 2026Release notes
Open source →- Initial release.
- Grid-based spritesheet animation (
SpriteAnimation.grid). - JSON atlas animation (
SpriteAnimation.atlas) with TexturePacker and Aseprite support. - Named animations via
frameTags. SpriteAnimationControllerwith play/pause/stop/goToFrame.- Playback modes: forward, reverse, pingPong.
- Per-frame duration from atlas data.
- Image precaching (
SpriteAnimation.precache/precacheAll). - Zero widget rebuilds via
CustomPainter(repaint:)— paint-layer-only updates. - Zero-allocation tick loop with raw microsecond arithmetic.
- Pre-computed grid rects for optimal rendering performance.
- Reusable Paint object to avoid per-frame allocations.
- Zero external dependencies (Flutter SDK only).