What is rolling_text?

rolling_text is a Flutter package that provides animated text and number display widgets. The core visual effect is a vertical rolling transition: when a value changes, each character slides up or down through a slot, similar to how digits flip on an old mechanical scoreboard or odometer. The animations are driven by spring physics, so each character bounces and settles rather than moving at a fixed speed. The package includes two main widgets. RollingText handles any string and animates character changes when the text updates. RollingNumber is specifically for numeric values and automatically decides the direction of the roll based on whether the number went up or down, with no extra configuration needed. RollingNumber supports decimal precision, prefix and suffix labels (like currency symbols or percent signs), thousand separators in both English and European comma-period formats, zero-padding, and automatic handling of negative sign characters. A stagger option lets each character in a word animate with a slight delay after the previous one, creating a ripple effect across the text. The bounce setting adds subtle variation in spring behavior per character so the animation feels less mechanical. An optional edge-fade property dims the top and bottom of each character slot to create an odometer-depth look. For situations where content is loading or processing, the package includes built-in waiting loops. Ellipsis mode cycles through trailing dots on a label, wave mode rolls each character in place in a repeating ripple, and shimmer mode passes a color highlight across static text. A progress loop cycles through a list of custom message frames. All of these are controlled through a RollingTextController that also provides a flash method for temporarily showing a confirmation message before reverting. The package respects system-level reduced-motion accessibility settings and has no third-party dependencies. It is available on pub.dev and licensed under MIT.