⚡ AnywhereLoader – Effortless Overlay Loader Without Context or Dependencies

A lightweight and customizable overlay loader for Flutter. No Stack, no context, no complex state management—just one-line integration to show loaders globally.

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().

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.