10 releases (1 stable)
Uses new Rust 2024
| new 1.0.0 | May 15, 2026 |
|---|---|
| 0.9.0 | May 14, 2026 |
| 0.8.0 | May 11, 2026 |
#688 in Game dev
Used in 7 crates
125KB
2K
SLoC
Italian: animato — animated, lively, with life and movement.
Animato
Animato is a stable, renderer-agnostic animation toolkit for Rust. It computes animated values and leaves rendering to your app, engine, terminal UI, browser, or embedded target.
The v1.0.0 API is stable. The current public crates cover easing, tweens, timelines, springs, motion paths, input physics, perceptual color interpolation, drivers, GPU batch evaluation, Bevy integration, and WASM/browser helpers.
Install
Most applications use the facade crate:
[dependencies]
animato = "1.0"
Enable only the integrations you need:
[dependencies]
animato = { version = "1.0", features = ["path", "physics", "color"] }
For no_std, depend on the focused crates directly:
[dependencies]
animato-core = { version = "1.0", default-features = false }
animato-tween = { version = "1.0", default-features = false }
animato-spring = { version = "1.0", default-features = false }
animato-path = { version = "1.0", default-features = false }
animato-physics = { version = "1.0", default-features = false }
animato-color = { version = "1.0", default-features = false }
Quick Start
use animato::{Easing, Tween, Update};
let mut tween = Tween::new(0.0_f32, 100.0)
.duration(1.0)
.easing(Easing::EaseOutCubic)
.build();
tween.update(0.5);
assert!(tween.value() > 50.0);
tween.update(0.5);
assert_eq!(tween.value(), 100.0);
assert!(tween.is_complete());
Core Concepts
Animato is built around four small traits:
| Trait | Purpose |
|---|---|
Interpolate |
Defines how a value lerps between two values. |
Animatable |
Blanket marker for values that can be animated. |
Update |
Advances animation state by a dt in seconds. |
Playable |
Object-safe animation interface used by timelines. |
The hot path is intentionally simple:
animation.update(dt);
let value = animation.value();
Animato never renders. Your application reads the computed value and applies it to a UI widget, game transform, DOM style, terminal cell, shader input, or any other target.
Crates
| Crate | Purpose | no_std |
|---|---|---|
animato-core |
Traits, interpolation, easing functions | yes |
animato-tween |
Tween<T>, keyframes, looping, modifiers |
yes |
animato-timeline |
Timelines, sequences, staggered starts | std |
animato-spring |
1D and component springs | yes |
animato-path |
Bezier, SVG paths, motion paths, morphing | yes/core |
animato-physics |
Inertia, drag tracking, gestures | yes/core |
animato-color |
Lab, Oklch, and linear color interpolation | yes |
animato-driver |
Animation driver, clocks, scroll driver | std |
animato-gpu |
Batched Tween<f32> evaluation with CPU fallback |
std |
animato-bevy |
Bevy ECS components, systems, completion messages | std |
animato-wasm |
rAF driver and optional DOM helpers | wasm/std |
animato |
Facade crate re-exporting stable APIs | feature gated |
Feature Flags
| Feature | What it adds |
|---|---|
default |
std, tween, timeline, spring, driver |
std |
Hosted functionality, wall clock, heap-backed helpers |
tween |
Tween<T>, KeyframeTrack<T>, Loop, TweenState |
timeline |
Timeline, Sequence, stagger, timeline callbacks |
spring |
Spring, SpringN<T>, SpringConfig presets |
path |
Bezier curves, SVG parser, motion paths, morphing, draw helpers |
physics |
Inertia, DragState, GestureRecognizer |
color |
InLab<C>, InOklch<C>, InLinear<C>, palette re-export |
driver |
AnimationDriver, clocks, ScrollDriver, ScrollClock |
gpu |
GpuAnimationBatch through wgpu with CPU fallback |
bevy |
AnimatoPlugin, tween/spring components, transform helpers |
wasm |
RafDriver, ScrollSmoother |
wasm-dom |
FLIP, split text, drag, observer, shared-element helpers |
serde |
Serialization for supported public types |
tokio |
Timeline::wait() async completion helper |
Examples
cargo run --example basic_tween
cargo run --example spring_demo
cargo run --example keyframe_track
cargo run --example timeline_sequence
cargo run --example motion_path --features path
cargo run --example morph_path --features path
cargo run --example scroll_linked --features driver
cargo run --example physics_drag --features physics
cargo run --example color_animation --features color
cargo run --example gpu_particles --features gpu
cargo run --example bevy_transform --features bevy
cargo run --example tui_progress
cargo run --example tui_spinner
WASM example:
cd examples/wasm_counter
wasm-pack build --target web
Documentation
The v1.0 documentation lives in docs/:
| Start here | Details |
|---|---|
| Getting Started | First animation and update loop. |
| API Full | Complete stable API map by crate. |
| Feature Flags | Exact feature requirements. |
| Concepts | Interpolate, Update, clocks, composition. |
| Recipes | Practical patterns for UI, games, paths, and input. |
| Testing | Local and CI verification commands. |
| Release | v1.0 publishing checklist. |
The generated Rust API docs are available on docs.rs/animato.
Testing
The v1.0 release gate is:
cargo fmt --check
cargo clippy --workspace --all-features -- -D warnings
cargo test --workspace --all-features
cargo test --workspace --no-default-features
cargo test -p animato --all-features --examples
cargo doc --workspace --all-features --no-deps
cargo check -p animato-wasm --target wasm32-unknown-unknown --features wasm-dom
cargo bench --workspace --no-run
Coverage and fuzzing are part of the stable release workflow when the tools are installed:
cargo llvm-cov --workspace --all-features --fail-under-lines 90
cargo +nightly fuzz run svg_path_parser -- -max_total_time=60
Stability
Animato follows Semantic Versioning. Starting at 1.0.0, public APIs are
treated as stable. Breaking changes require a future major release and migration
notes. The focused sub-crates can still be used independently when a project
needs tighter dependency control than the facade provides.
Project Docs
Support
- Star the repo on GitHub
- Open issues for reproducible bugs and clear feature requests
- Support development through Buy Me a Coffee
License
Licensed under either of:
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this project is dual-licensed as above, without additional terms or conditions.
Dependencies
~510–710KB
~15K SLoC