company_branded_loader 0.0.2
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.