company_branded_loader 0.0.2 copy "company_branded_loader: ^0.0.2" to clipboard
company_branded_loader: ^0.0.2 copied to clipboard

A customizable Flutter branded loader overlay with animated company text, canvas effects, blur, and dynamic API status support.

company_branded_loader #

A premium Flutter loader overlay package for API calls, uploads, syncing flows, and waiting states. It keeps your brand front and center with a glassmorphism card, canvas-based orbit animation, animated company name, dynamic status messaging, and smooth blurred transitions.

Features #

✅ Premium branded API loader overlay
✅ Glassmorphism loader card
✅ Canvas-based animated orbit loader
✅ Animated company/app name
✅ Dynamic status text
✅ Optional Lottie/custom animation support
✅ Smooth blur and fade transition
✅ Blocks user interaction while loading
✅ Fully customizable colors and styles
✅ No required third-party dependencies
✅ Works with GetX, Bloc, Provider, Riverpod, setState

Installation #

dependencies:
  company_branded_loader: ^0.0.1

Then run:

flutter pub get

Platform Support #

This package is built with Flutter SDK widgets only and supports:

  • Android
  • iOS
  • Web
  • Desktop where Flutter UI apps are supported

Basic Usage #

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

CompanyBrandedLoaderOverlay(
  isLoading: isLoading,
  companyName: 'CoreDron',
  child: const MyScreen(),
)

Dynamic Status Text #

CompanyBrandedLoaderOverlay(
  isLoading: isLoading,
  companyName: 'CoreDron',
  dynamicStatusText: statusText,
  child: const MyScreen(),
)

The company name always remains visible as the brand title. The status line below it changes dynamically, and when no status is provided it falls back to:

Please wait while we process your request

Custom Accent Color #

CompanyBrandedLoaderOverlay(
  isLoading: isLoading,
  companyName: 'CoreDron',
  dynamicStatusText: 'Processing request',
  accentColor: const Color(0xFF00E5FF),
  barrierColor: Colors.black54,
  cardColor: const Color(0x8A000000),
  child: const MyScreen(),
)

Custom Animation Widget #

You can keep the package dependency-free and still plug in your own animation widget, including Lottie:

CompanyBrandedLoaderOverlay(
  isLoading: isLoading,
  companyName: 'CoreDron',
  dynamicStatusText: 'Syncing data',
  customAnimation: Lottie.asset(
    'assets/loader.json',
    width: 90,
    height: 90,
  ),
  child: const MyScreen(),
)

The package does not depend on lottie; consumers can add it themselves if they want that mode.

Full Example #

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

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

class BrandedLoaderExampleApp extends StatelessWidget {
  const BrandedLoaderExampleApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: CompanyBrandedLoaderOverlay(
        isLoading: true,
        companyName: 'CoreDron',
        dynamicStatusText: 'Fetching data',
        accentColor: const Color(0xFF00E5FF),
        child: const Scaffold(
          body: Center(
            child: Text('Dashboard'),
          ),
        ),
      ),
    );
  }
}

The bundled example app demonstrates:

  • Basic loader mode
  • Dynamic multi-step API status mode
  • Custom animation widget mode

Screenshots / GIFs #

  • Add a preview GIF of the orbit animation here before publishing to GitHub or pub.flutter-io.cn.
  • Add one static screenshot showing the glass card, company title, and status text overlay.

API Reference #

Property Type Required Default Description
isLoading bool Yes - Shows or hides the overlay.
child Widget Yes - Original content beneath the overlay.
companyName String Yes CoreDron Brand title shown in the card.
dynamicStatusText String? No null Dynamic status line shown below the brand title.
customAnimation Widget? No null Optional custom animation widget displayed above the text.
accentColor Color No Color(0xFF00E5FF) Accent color for glow, orbit arcs, and shimmer.
cardColor Color No Color(0x8A000000) Glass card background color.
barrierColor Color No Color(0x8A000000) Dark overlay barrier color.
blurSigma double No 8 Blur intensity behind the overlay.
transitionDuration Duration No 350ms Fade/scale transition duration.
companyTextStyle TextStyle? No null Custom style for the company title.
statusTextStyle TextStyle? No null Custom style for the status line.
showAnimatedDots bool No true Enables animated trailing dots on the status text.
enableCanvasAnimation bool No true Shows the built-in orbit loader when no custom animation is supplied.
enablePulseAnimation bool No true Enables pulse/shimmer motion in the loader.
loaderPadding EdgeInsetsGeometry No EdgeInsets.symmetric(horizontal: 32, vertical: 28) Inner padding for the loader card.
borderRadius BorderRadiusGeometry No BorderRadius.circular(28) Card radius.
maxLoaderWidth double No 320 Maximum width of the centered loader card.

Notes #

  • No direct state management dependency.
  • No direct Lottie dependency.
  • Suitable for production mobile and web apps.

License #

Copyright © 2026 CoreDron. This package is released under the MIT License. See LICENSE.

0
likes
160
points
28
downloads

Documentation

API reference

Publisher

unverified uploader

Weekly Downloads

A customizable Flutter branded loader overlay with animated company text, canvas effects, blur, and dynamic API status support.

Repository (GitHub)
View/report issues

Topics

#loader #overlay #animation #ui

License

MIT (license)

Dependencies

flutter

More

Packages that depend on company_branded_loader