Anywhere Loader #

A simple and customizable overlay loader built using Flutter. No need for manual Stack or complex state management—just plug and play with AnywhereLoader.

Features #

• 🟢 Uses Overlay instead of Stack for smooth integration.
• 🎨 Customizable font size, font color, and font family.
• 🔄 Supports async operations.
• 🔍 Blur effect on background while loading.
• 🚀 Simple API: Just wrap your widget and call startLoader().

Installation #

Add this to your pubspec.yaml:

dependencies:
anywhere_loader: latest_version

Then run:

flutter pub get

Usage #

1️⃣ ⚙️ Setup #

Wrap your screen (not the whole app) inside AnyWhereLoaderContextProvider. This should be placed inside the MaterialApp:

import 'package:flutter/material.dart';
import 'package:anywhere_loader/anywhere_loader.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Anywhere Loader Demo',
      debugShowCheckedModeBanner: false,
      home: AnyWhereLoaderContextProvider(
        child: HomePage(),
      ),
    );
  }
}

2️⃣ Start and Stop Loader #

To start the loader anywhere in your app:

AnywhereLoader.instance.startLoader(
  text: "Loading data...",
  seconds: 5, // Default is 10 seconds
  fontSize: 18,
  fontColor: Colors.white,
  fontFamily: 'Arial',
);

To stop the loader manually:

AnywhereLoader.instance.stopLoader();

3️⃣ Using runWithLoader() (Recommended for async calls) #

Use this method to automatically show a loader while executing any async function like API calls, database operations, etc.

await AnyWhereLoader.instance.showAsyncLoader(
 asyncFunction: () async {
 // Simulate a network call or long task
 await Future.delayed(const Duration(seconds: 5));
},
 text: "Loading, please wait...",
);

✅ The loader automatically starts and stops. 💡 Ideal for API calls or tasks where you don’t want to manually call startLoader() and stopLoader().

4️⃣ Use Custom Loader Widget #

You can replace the default loader with your own widget:

AnywhereLoader.instance.startLoader(
  customWidget: Center(
    child: Column(
      mainAxisSize: MainAxisSize.min,
      children: [
        CircularProgressIndicator(),
        SizedBox(height: 10),
        Text("Fetching data...")
      ],
    ),
  ),
);

License #

This package is released under the MIT License.