What is flutter_timer_button?

flutter_timer_button is a Flutter package that gives you a button which can count down or show progress, with a visual fill effect that animates across the button as time passes or work completes. It is aimed at situations like OTP resend cooldowns, rate limited actions, or tracking an upload, sync, or download. Most similar packages only disable the button and show a countdown number. This one adds an animated fill indicator so users can see progress happening, not just read a number. The package supports two modes: countdown and progress. In countdown mode, tapping the button calls your function and starts a timer, during which the button is disabled and shows a label like "Resend in Ns" until the countdown finishes. In progress mode, you control a TimerButtonController and call setProgress with a value from 0 to 1 whenever you want, for example from a network callback or a stream listener, and the button's fill animates to match. The button is built around three pieces: TimerButton, the widget itself, with properties for duration, callbacks like onPressed, onCompleted, and onTick, and options like whether the button disables while running or auto starts, TimerButtonController, which tracks whether the timer is running or completed, exposes elapsed and remaining time as fractions, and lets you start, pause, resume, stop, or reset, and TimerButtonStyle, which controls the look of the button through filled, outlined, or dark presets, each customizable with colors. To use it, add flutter_timer_button to your pubspec dependencies, then use the TimerButton.countdown or TimerButton.progress constructors, which come with sensible defaults already wired up. This is a small, focused UI component rather than a full application. There are no tests, CI configuration, or contribution guidelines described in the README beyond a note that issues and contributions are welcome on the project's GitHub page. The project currently has no stars and appears to be new.