cue
0.4.0, released 2 months ago by codeness.ly
Physics-first Flutter animations with a composable, timeline-driven API
What it does
Provides a composable, timeline-driven API for physics-based and keyframed animations in Flutter without wiring imperative controllers through the widget tree. It separates triggers, actors, effects, and motions to create smooth transitions, state animations, and scroll-driven effects.
AI-written summary of version 0.4.0, based on the package's README and metadata. Report an inaccuracy
Use it when
- You want physics-based or spring animations without boilerplate animation controllers.
- You need timeline-driven or scroll-driven UI motion in your Flutter app.
- You want to organize complex UI animations into declarative actors, acts, and cues.
Skip it when
- You are loading and rendering pre-compiled complex vector animations from external files (like Lottie).
- You only need basic built-in implicit widgets and do not require timeline or physics configuration.
Strengths
- Clean separation between triggers, targets, effects, and motion curves.
- Supports diverse trigger patterns including mounting, scrolling, hovering, and focusing.
- Reduces controller boilerplate compared to standard AnimationController setups.
Weaknesses
- Requires learning a custom API and set of building blocks (Cues, Actors, Acts).
- Actors throw an error if used without an ancestor Cue.
Setup
- Kind
- Flutter widgets
- Effort
- Low
- Code generation
- No
- Direct dependencies
- 1
Cue.onMount(
motion: .smooth(),
child: Actor(
acts: [
.fadeIn(),
.slideY(from: 0.2),
.scale(from: 0.96),
],
child: const Text('Hello Cue'),
),
)Alternatives
Packages that do the same job and could replace cue.
- flutter_animate
If you prefer a simpler fluent extension-based API for quick chaining of widget animations.
70Compare - lottie
If you need to render complex designer-created vector animations exported from After Effects.
96Compare
Works with
Packages commonly used together with cue: ones it builds on, ones built on it, and its own family.