Package selection guidance compiled from public package information, community data, and project usage.
A customizable progress button widget for Flutter that supports Android, iOS, Web, macOS, Windows, and Linux. It allows developers to create buttons with dynamic states such as loading, success, error, and idle, enhancing user feedback during actions like form submissions or API calls. The widget is highly configurable, enabling customization of colors, labels, icons, and animations. It integrates seamlessly into existing Flutter apps and provides a consistent experience across platforms.
Use cases
Form submission with loading state
Authentication flow progress
File upload indicators
Payment processing UI
Onboarding wizard steps
Key features
Multiple state support (idle, loading, success, error)
Customizable appearance and behavior
Cross-platform compatibility
Animated transitions between states
Configurable labels and icons
Easy integration with existing widgets
Suitable for
Developers building interactive forms
Teams prioritizing UX consistency
Apps requiring real-time feedback
Cross-platform mobile and web applications
Projects with complex user workflows
Considerations
Requires understanding of Flutter state management
May need additional styling for complex designs
Limited to button-specific use cases
Not suitable for non-interactive elements
Depends on platform-specific rendering behaviors
Original README
Original README snapshot from the linked source repository. Visit the repository for the latest content.
stateWidgets - Widgets of states
stateColors - Background color oof states
state = ButtonState.idle` - Current state of button
onPressed - onPressed function same like MaterialButton
onAnimationEnd - onAnimatedEnd function calls like that onAnimatedEnd(AnimationStatus animationStatus,ButtonState currentState).
minWidth = 200.0 - Loading state width
maxWidth = 400.0 - failed,success,idle states width
radius = 16.0 - Button radius
height = 53.0 - Button height
circularProgressIndicator - CircularProgressIndicator widget, defaultis instating with current state color.
progressIndicatorAlignment = MainAxisAlignment.spaceBetween` - ProgressIndicator aligment
progressIndicatorSize = 35.0 - size of progress indicator
padding = EdgeInsets.zero - Padding of button
minWidthStates = List of min width states, loading is the default. If you want to make small only icon states define them onthis.
animationDuration = Transition animation duration.
ProgressButton.icon() specific constructors
Map<ButtonState, IconedButton> iconedButtons- State and IconedButton map
double iconPadding: 4.0 - Padding of icon
TextStyle textStyle - TextStyle of all of states
License
This project is licensed under the MIT License - see the LICENSE.md file for details