Easy to use mixin ScreenLoader, which will handle the loading on the screen without using state or navigation stack. You can customise the loading as well.
Package selection guidance compiled from public package information, community data, and project usage.
ScreenLoader is a Flutter/Dart package that provides a simple mixin to manage on-screen loading states without requiring explicit state management or navigation stack manipulation. It enables developers to display and control loading indicators across screens with minimal boilerplate. The package supports customization of the loading UI, making it adaptable to various design needs. Ideal for apps needing consistent, reusable loading experiences across multiple widgets.
Use cases
Displaying loading overlays during async operations
Simplifying loading state management in forms
Adding loading indicators to API calls
Creating reusable loading components
Enhancing UX with smooth loading transitions
Reducing boilerplate in screen-level loading logic
Key features
Mixin-based loading implementation
Customizable loading UI
No need for state management
Works across all platforms
Minimal setup required
Supports asynchronous operation handling
Suitable for
Developers seeking lightweight loading solutions
Teams using minimal state management
Apps with frequent async data fetching
UI-heavy applications needing consistent loaders
Flutter beginners exploring loading patterns
Cross-platform apps targeting multiple devices
Considerations
Limited to basic loading functionality
Requires manual integration with async workflows
Not suitable for complex loading states
May need additional styling for custom designs
Depends on proper widget tree structure
Does not handle error states by default
Original README
Original README snapshot from the linked source repository. Visit the repository for the latest content.
screen_loader
Why ScreenLoader?
With the help of stream_mixin, it shows and hides the loader without updating the state of the widget which increases the performance
It does not push any sort of widget to navigation stack, this helps in not messing up the navigation stack and context
Easy to use, just use your screen with ScreenLoader mixin and wrap the widget with loadableWidget
The loader is customizable. You can use any widget as a loader
You can configure same loader for all the screens at once
You can also configure different loader for different screens
Basic usage
Use your screen with the ScreenLoader mixin
Wrap the widget with loadableWidget
Use performFuture function to show loader while your future is being performed
Configure different loader for individual screen
Simply overide loader() method
loader() {
// here any widget would doreturnAlertDialog(
title: Text('Wait.. Loading data..'),
);
}
Global loader: the one you specify in configScreenLoader. Note: if you don't override local(), this loader will be used
Default loader: if you don't specify global loader or override local loader, this loader will be used
Migration guide to 4.0.0
ScreenLoaderApp widget is removed. Now no need to wrap your App around any widget just to set the global configurations. Instead call configScreenLoader() before runApp()
Instead of replacing the build function with screen use the build function itself and wrap the widget you want to show loader on with the loadableWidget.