Async Confirm Dialog #

A zero-boilerplate, async-aware confirmation dialog for Flutter.

Every Flutter developer writes confirmation dialogs that tie into asynchronous APIs: deletes, logouts, saves, updates. Standard dialogs force you to manually manage loading states, disable buttons, and guard against double-taps. This package handles all of that for you.

Demo #

The example app running on iOS:

Demo 1	Demo 2

Tap any tile in the example to try the dialogs: standard confirms, destructive actions, async failures, and fully custom styles.

Highlights #

• Zero-boilerplate API. One call returns a Future<bool?>.
• Native async support. Pass an onConfirm callback and the confirm button automatically shows a spinner, disables the cancel action, suppresses back/barrier dismissal, and blocks double-taps.
• Graceful error handling. A thrown async action keeps the dialog open, shows an inline error, and lets the user retry.
• Material and Cupertino. Adapts to the platform theme automatically or can be forced manually.
• Deeply customizable. A rich AsyncConfirmDialogStyle for colors, typography, corners, padding, and layout.

Installation #

Add the dependency to your pubspec.yaml:

dependencies:
  async_confirm_dialog: ^1.0.0

Then run:

flutter pub get

Quick start #

Show a dialog and act on the result:

import 'package:async_confirm_dialog/async_confirm_dialog.dart';

final confirmed = await AppDialog.confirm(
  context,
  title: 'Delete this note?',
  message: 'This action cannot be undone.',
  variant: ConfirmDialogVariant.destructive,
  onConfirm: () => notesRepository.remove(id),
);

if (confirmed == true) {
  // Success path.
}

A builder-style extension is also available:

final ok = await context.confirm(
  title: 'Log out?',
  message: 'You will need to sign in again.',
  variant: ConfirmDialogVariant.destructive,
  onConfirm: () => auth.signOut(),
);

Async lifecycle #

When onConfirm is supplied, the dialog transitions into a loading state on tap:

1. The confirm button is replaced by a progress indicator.
2. The cancel action is disabled.
3. Back navigation and barrier dismissal are suppressed.
4. Further taps on the confirm action are ignored.

On success the dialog pops with true (unless dismissOnConfirm: false). On failure the loading state clears, onError fires, and an inline error is shown so the user can retry.

final ok = await AppDialog.confirm(
  context,
  title: 'Run report?',
  confirmText: 'Run',
  onConfirm: generateReport,
  onError: (error, stack) => log.severe('Report failed: $error'),
  errorMessage: 'We could not generate the report. Please try again.',
);

Customization #

Force a design language:

AppDialog.confirm(
  context,
  title: 'Confirm',
  platform: DialogPlatform.cupertino, // DialogPlatform.material or .adaptive
);

Style the dialog with AsyncConfirmDialogStyle:

AppDialog.confirm(
  context,
  title: 'Careful',
  variant: ConfirmDialogVariant.destructive,
  style: AsyncConfirmDialogStyle(
    confirmColor: Colors.amber,
    destructiveColor: Colors.red,
    borderRadius: BorderRadius.circular(20),
    contentAlign: TextAlign.center,
  ),
);

The returned values:

Example #

The example/ directory contains a runnable app covering standard, destructive, async-failure, and fully custom dialogs. It is configured for both iOS and Android:

cd example
flutter run

Author and Contact #

Developed and maintained by Ebrahim Joy.

• Email: eebrahimjoy@gmail.com
• Website: eebrahimjoy.com
• GitHub: @eebrahimjoy

Contributing #

Please report bugs and request features through the issue tracker. Pull requests are welcome.

License #

Released under the MIT License.