KAlertFlutter

A modern, professional, customizable Material-style alert dialog library for Flutter.

---

🚀 What is KAlertFlutter?

KAlertFlutter is a lightweight, modern, and professional alert dialog package for Flutter.

It is inspired by the native Android Java library KAlertDialog and brings a similar beautiful dialog experience to Flutter apps.

With KAlertFlutter, you can quickly create:

• Success dialogs
• Error dialogs
• Warning dialogs
• Info dialogs
• Question dialogs
• Confirm dialogs
• Prompt/input dialogs
• Progress/loading dialogs
• Custom image dialogs
• URL image dialogs
• Custom view dialogs
• Modern styled dialogs
• Dark mode friendly dialogs
• Input validation dialogs
• Fully customizable button dialogs

---

🌐 Related Native Android Library

KAlertFlutter is designed to match the native Android Java library KAlertDialog.

If you are building a native Android app in Java, use the Android version here:

Native Android Java Library:
https://github.com/TutorialsAndroid/KAlertDialog

---

🔗 pub.dev Package

https://pub.dev/packages/kalertflutter

---

❤️ Support the Project

If you find KAlertFlutter useful, please support the project:

⭐ Star this repository
🐛 Report issues
💡 Suggest new features
📦 Like the package on pub.dev
🚀 Share it with other Flutter developers

Follow me on Instagram for more developer content:

📸 https://instagram.com/coderx09

Thanks for your support! 🚀

---

✨ Features

Dialog Types

• ✅ Normal dialog
• ✅ Success dialog
• ✅ Error dialog
• ✅ Warning dialog
• ✅ Info dialog
• ✅ Question dialog
• ✅ Confirm dialog
• ✅ Prompt/input dialog
• ✅ Progress/loading dialog
• ✅ Custom image dialog
• ✅ URL image dialog
• ✅ Custom view dialog

Styling Features

• ✅ Modern Material-style UI
• ✅ Rounded dialog corners
• ✅ Modern style presets
• ✅ Classic style preset
• ✅ Minimal style preset
• ✅ Rounded style preset
• ✅ Custom dialog corner radius
• ✅ Custom dialog elevation
• ✅ Custom dialog dim amount
• ✅ Dark mode support
• ✅ Custom title text style
• ✅ Custom content text style
• ✅ Title font weight support
• ✅ Content font weight support
• ✅ Button font weight support
• ✅ Button text size support
• ✅ Button all-caps control
• ✅ Custom button colors
• ✅ Custom icon colors
• ✅ Custom background colors

Advanced Features

• ✅ Input validation
• ✅ Input max length
• ✅ Input keyboard type
• ✅ Input confirm callback
• ✅ Custom Flutter widget inside dialog
• ✅ URL image big mode
• ✅ URL image circle mode
• ✅ URL image placeholder
• ✅ URL image error widget
• ✅ Progress dialog
• ✅ Show callback
• ✅ Dismiss callback
• ✅ Confirm callback
• ✅ Cancel callback
• ✅ Backward compatible old API

---

📸 Screenshot Gallery

Add your screenshots inside the art/new/ folder using the same file names shown below.

Modern Success Dialog	Custom Radius, Elevation and Dim	Title and Content Font Weight
Basic Message Dialog	Error Dialog	Warning Confirm / Cancel Flow	Info Dialog	Question Dialog
Input Dialog with Validation	Custom View Dialog
Custom Image Dialog	URL Image Circle Dialog	Big URL Image Dialog
Button Styling	Progress Dialog	Show and Dismiss Callbacks

---

📦 Installation

Add this to your pubspec.yaml:

dependencies:
  kalertflutter: ^2.0.0

Then run:

flutter pub get

---

🚀 Import

import 'package:kalertflutter/kalertflutter.dart';

---

⚡ Quick Start

KAlertDialog.success(
  context: context,
  title: 'Success',
  content: 'Your changes were saved successfully.',
  confirmText: 'Done',
);

---

🎨 Dialog Types

KAlertFlutter supports these dialog types:

KAlertType.normal
KAlertType.success
KAlertType.error
KAlertType.warning
KAlertType.info
KAlertType.question
KAlertType.progress
KAlertType.input
KAlertType.customImage
KAlertType.urlImage
KAlertType.customView

---

🎭 Style Presets

KAlertFlutter includes modern style presets:

KAlertStyle.classic
KAlertStyle.modern
KAlertStyle.minimal
KAlertStyle.rounded

Example:

KAlertDialog.show(
  context: context,
  title: 'Modern Dialog',
  content: 'This dialog uses the modern style preset.',
  type: KAlertType.normal,
  style: KAlertStyle.modern,
);

---

✅ Success Dialog

KAlertDialog.success(
  context: context,
  title: 'Success',
  content: 'Your action was completed successfully.',
  confirmText: 'OK',
);

---

❌ Error Dialog

KAlertDialog.error(
  context: context,
  title: 'Oops...',
  content: 'Something went wrong. Please try again.',
  confirmText: 'Try Again',
);

---

⚠️ Warning Dialog

KAlertDialog.warning(
  context: context,
  title: 'Are you sure?',
  content: 'This action cannot be undone.',
  confirmText: 'Confirm',
  cancelText: 'Cancel',
);

---

ℹ️ Info Dialog

KAlertDialog.info(
  context: context,
  title: 'Information',
  content: 'Here is some useful information.',
  confirmText: 'Got it',
);

---

❓ Question Dialog

final result = await KAlertDialog.question(
  context: context,
  title: 'Continue?',
  content: 'Do you want to continue with this action?',
  confirmText: 'Yes',
  cancelText: 'No',
);

if (result?.confirmed == true) {
  debugPrint('User selected yes');
}

---

🗑️ Confirm Dialog / Warning Flow

final result = await KAlertDialog.warning(
  context: context,
  title: 'Delete this file?',
  content: 'This action cannot be undone.',
  confirmText: 'Delete',
  cancelText: 'Cancel',
);

if (result?.confirmed == true) {
  KAlertDialog.success(
    context: context,
    title: 'Deleted',
    content: 'The file has been deleted successfully.',
  );
} else if (result?.cancelled == true) {
  KAlertDialog.error(
    context: context,
    title: 'Cancelled',
    content: 'Your file is safe. No changes were made.',
  );
}

---

🔄 Progress Dialog

KAlertDialog.progress(
  context: context,
  title: 'Processing',
  content: 'Please wait while we prepare your request.',
  barrierDismissible: false,
);

Example with auto close:

KAlertDialog.progress(
  context: context,
  title: 'Processing',
  content: 'Please wait while we prepare your request.',
  barrierDismissible: false,
);

await Future.delayed(const Duration(seconds: 3));

if (context.mounted) {
  Navigator.of(context).pop();

  KAlertDialog.success(
    context: context,
    title: 'Completed',
    content: 'Your request has been completed successfully.',
  );
}

---

⌨️ Input Dialog with Validation

final result = await KAlertDialog.input(
  context: context,
  title: 'Create Project',
  content: 'Enter a project name with at least 3 characters.',
  hintText: 'Project name',
  initialValue: 'KAlertFlutter',
  maxLength: 30,
  validator: (input) {
    if (input.trim().length < 3) {
      return 'Project name must be at least 3 characters';
    }
    return null;
  },
  onInputConfirm: (input) {
    debugPrint('Created: $input');
  },
);

if (result?.confirmed == true) {
  debugPrint('Input value: ${result?.value}');
}

---

🧩 Custom View Dialog

You can place any Flutter widget inside the dialog.

final controller = TextEditingController();

KAlertDialog.customView(
  context: context,
  title: 'Custom View',
  content: 'This dialog uses your own custom Flutter widget.',
  showCancelButton: true,
  confirmText: 'Save',
  cancelText: 'Cancel',
  child: Column(
    mainAxisSize: MainAxisSize.min,
    children: [
      TextField(
        controller: controller,
        decoration: const InputDecoration(
          labelText: 'Project name',
          hintText: 'Example: KAlertFlutter Pro',
          border: OutlineInputBorder(),
        ),
      ),
      const SizedBox(height: 10),
      const Text(
        'You can place any custom widget inside KAlertFlutter.',
        textAlign: TextAlign.center,
      ),
    ],
  ),
  onConfirm: () {
    debugPrint('Saved: ${controller.text}');
  },
);

---

🖼️ Custom Image Dialog

KAlertDialog.customImage(
  context: context,
  title: 'Custom Image',
  content: 'You can show an asset image, memory image or network image provider.',
  image: const AssetImage('assets/logo.png'),
  confirmText: 'OK',
);

Using network image provider:

KAlertDialog.customImage(
  context: context,
  title: 'Custom Image',
  content: 'This image uses NetworkImage.',
  image: const NetworkImage('https://example.com/image.png'),
);

---

🌐 URL Image Dialog

KAlertFlutter supports two URL image display types:

KAlertImageType.big
KAlertImageType.circle

---

Big URL Image

KAlertDialog.urlImage(
  context: context,
  title: 'Big URL Image',
  content: 'This image is loaded from a URL.',
  imageUrl: 'https://example.com/image.png',
  imageType: KAlertImageType.big,
  confirmText: 'Close',
);

---

Circle URL Image

KAlertDialog.urlImage(
  context: context,
  title: 'Circle URL Image',
  content: 'This image is shown in circle crop mode.',
  imageUrl: 'https://example.com/image.png',
  imageType: KAlertImageType.circle,
  confirmText: 'Nice',
);

---

🎨 Custom Dialog Appearance

KAlertDialog.show(
  context: context,
  title: 'Custom Appearance',
  content: 'This dialog has custom radius, elevation and dim amount.',
  type: KAlertType.normal,
  style: KAlertStyle.modern,
  cornerRadius: 30,
  elevation: 20,
  dimAmount: 0.60,
  backgroundColor: Colors.white,
  confirmText: 'Looks Good',
);

Available appearance options:

cornerRadius: 30
elevation: 20
dimAmount: 0.60
maxWidth: 360
backgroundColor: Colors.white
titleColor: Colors.black
contentColor: Colors.grey
iconColor: Colors.green

---

🔠 Font Weight and Text Styling

KAlertDialog.show(
  context: context,
  title: 'Font Weight Support',
  content: 'You can control title, content and button font weights.',
  type: KAlertType.normal,
  style: KAlertStyle.modern,
  titleFontWeight: FontWeight.w900,
  contentFontWeight: FontWeight.w500,
  confirmButtonFontWeight: FontWeight.w900,
  titleTextSize: 22,
  contentTextSize: 15,
  buttonTextSize: 15,
  confirmText: 'Awesome',
);

---

🔘 Button Styling

KAlertDialog.show(
  context: context,
  title: 'Button Styling',
  content: 'This example shows button text size, font weight, all caps control and custom colors.',
  type: KAlertType.normal,
  style: KAlertStyle.minimal,
  showCancelButton: true,
  confirmText: 'Accept',
  cancelText: 'Decline',
  confirmButtonColor: const Color(0xFF10B981),
  cancelButtonColor: const Color(0xFFE2E8F0),
  cancelTextColor: const Color(0xFF334155),
  confirmButtonFontWeight: FontWeight.w900,
  cancelButtonFontWeight: FontWeight.w900,
  buttonTextSize: 15,
  confirmButtonAllCaps: false,
  cancelButtonAllCaps: false,
);

---

🌙 Dark Mode Support

KAlertFlutter automatically respects your Flutter app theme.

Example:

MaterialApp(
  themeMode: ThemeMode.system,
  theme: ThemeData(
    useMaterial3: true,
    brightness: Brightness.light,
  ),
  darkTheme: ThemeData(
    useMaterial3: true,
    brightness: Brightness.dark,
  ),
  home: const HomePage(),
);

KAlertFlutter will automatically adapt when the app is in dark mode.

---

🔔 Callback APIs

KAlertDialog.show(
  context: context,
  title: 'Callbacks',
  content: 'This dialog shows callback APIs.',
  type: KAlertType.normal,
  showCancelButton: true,
  confirmText: 'Confirm',
  cancelText: 'Cancel',
  onShow: () {
    debugPrint('Dialog shown');
  },
  onDismiss: () {
    debugPrint('Dialog dismissed');
  },
  onConfirm: () {
    debugPrint('Confirmed');
  },
  onCancel: () {
    debugPrint('Cancelled');
  },
);

---

🔙 Backward Compatible Old API

Your previous API is still supported.

---

Old KAlert.show()

KAlert.show(
  context,
  title: 'Success',
  message: 'Saved successfully!',
  type: KAlertType.success,
);

---

Old KAlert.confirm()

bool? result = await KAlert.confirm(
  context,
  title: 'Delete file?',
  message: 'This action cannot be undone',
);

if (result == true) {
  debugPrint('User confirmed');
}

---

Old KAlert.prompt()

String? value = await KAlert.prompt(
  context,
  title: 'Enter your name',
  hintText: 'Your name',
);

debugPrint(value);

---

📘 Complete Example

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

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

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

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'KAlertFlutter Demo',
      debugShowCheckedModeBanner: false,
      themeMode: ThemeMode.system,
      theme: ThemeData(
        useMaterial3: true,
        colorSchemeSeed: const Color(0xFF00D6C9),
        brightness: Brightness.light,
      ),
      darkTheme: ThemeData(
        useMaterial3: true,
        colorSchemeSeed: const Color(0xFF00D6C9),
        brightness: Brightness.dark,
      ),
      home: const DemoHomePage(),
    );
  }
}

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

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('KAlertFlutter Demo'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            KAlertDialog.success(
              context: context,
              title: 'Success',
              content: 'KAlertFlutter is working perfectly!',
              confirmText: 'Done',
            );
          },
          child: const Text('Show Dialog'),
        ),
      ),
    );
  }
}

---

🧪 Local Testing

If you are developing this package locally, run:

flutter clean
flutter pub get
flutter analyze
flutter test

To run the example app:

cd example
flutter pub get
flutter run

If the Android folder is missing inside example, run:

cd example
flutter create .
flutter pub get
flutter run

---

📂 Repository

GitHub:

https://github.com/TutorialsAndroid/KAlertFlutter

Issues and feature requests are welcome.

---

📦 Package

pub.dev:

https://pub.dev/packages/kalertflutter

---

🤝 Related Projects

KAlertDialog for Native Android Java

If you are building a native Android app using Java, check out the original Android library:

KAlertDialog
https://github.com/TutorialsAndroid/KAlertDialog

---

📝 Migration from Older Version

Older versions used:

KAlert.show()
KAlert.confirm()
KAlert.prompt()

These methods are still available.

New recommended API:

KAlertDialog.success()
KAlertDialog.error()
KAlertDialog.warning()
KAlertDialog.info()
KAlertDialog.question()
KAlertDialog.progress()
KAlertDialog.input()
KAlertDialog.customView()
KAlertDialog.customImage()
KAlertDialog.urlImage()

---

📌 API Summary

Dialog Types

KAlertType.normal
KAlertType.success
KAlertType.error
KAlertType.warning
KAlertType.info
KAlertType.question
KAlertType.progress
KAlertType.input
KAlertType.customImage
KAlertType.urlImage
KAlertType.customView

Styles

KAlertStyle.classic
KAlertStyle.modern
KAlertStyle.minimal
KAlertStyle.rounded

Image Types

KAlertImageType.big
KAlertImageType.circle

Main Methods

KAlertDialog.show()
KAlertDialog.success()
KAlertDialog.error()
KAlertDialog.warning()
KAlertDialog.info()
KAlertDialog.question()
KAlertDialog.progress()
KAlertDialog.input()
KAlertDialog.customView()
KAlertDialog.customImage()
KAlertDialog.urlImage()

Backward Compatible Methods

KAlert.show()
KAlert.confirm()
KAlert.prompt()

---

📜 License

MIT License

Free for personal and commercial use.

MIT License

Copyright (c) 2026 TutorialsAndroid

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files, to deal in the Software
without restriction, including without limitation the rights to use, copy,
modify, merge, publish, distribute, sublicense, and/or sell copies of the
Software, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

---

Made with ❤️ by TutorialsAndroid

If this package helps you, please ⭐ star the repository and 👍 like the package on pub.dev.