Skip to content
pubscout

cue

0.4.0, released 2 months ago by codeness.ly

Physics-first Flutter animations with a composable, timeline-driven API

WASM-readyUses material_ui
$ flutter pub add cue
Source repository

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.

  • lottie

    If you need to render complex designer-created vector animations exported from After Effects.

Works with

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