v3c_alert 1.0.1

A customizable alert dialog widget for Flutter with success, warning, info, and error types.

V3C Alert

A customizable Flutter alert dialog widget supporting success, warning, error, and info alerts.

Features

• 🎨 Different alert types: Success, Error, Warning, Info
• 🛠️ Fully customizable: titles, descriptions, button actions
• 🎞️ Smooth animation support when displaying alerts
• ✅ Callbacks for both OK and Cancel buttons

📦 Installation

Add this to your package's pubspec.yaml file:

dependencies:
  v3c_alert:

Run flutter pub get to install the package.

Usage

Import the package in your Dart code:

import 'package:v3c_alert/v3c_alert.dart';

Example

Here's how you can use the V3CAlertDialog in your app:

Success Alert

void _showSuccessAlert() {
  V3CAlert(
    context: context,
    title: 'Success!',
    description: 'Your operation has been completed successfully.',
    alertType: V3CAlertType.success,
    okOnPress: () {
      setState(() {
        _lastAction = 'Success alert - OK pressed';
      });
    },
    cancelOnPress: () {
      setState(() {
        _lastAction = 'Success alert - Cancelled';
      });
    },
  ).show();
}

Error Alert

void _showErrorAlert() {
  V3CAlert(
    context: context,
    title: 'Error!',
    description:
        'An error occurred while processing your request. Please try again.',
    alertType: V3CAlertType.error,
    okOnPress: () {
      setState(() {
        _lastAction = 'Error alert - OK pressed';
      });
    },
    cancelOnPress: () {
      setState(() {
        _lastAction = 'Error alert - Cancelled';
      });
    },
  ).show();
}

Warning Alert

void _showWarningAlert() {
  V3CAlert(
    context: context,
    title: 'Warning!',
    description:
        'This action cannot be undone. Are you sure you want to continue?',
    alertType: V3CAlertType.warning,
    okOnPress: () {
      setState(() {
        _lastAction = 'Warning alert - Confirmed';
      });
    },
    cancelOnPress: () {
      setState(() {
        _lastAction = 'Warning alert - Cancelled';
      });
    },
  ).show();
}

Info Alert

void _showInfoAlert() {
  V3CAlert(
    context: context,
    title: 'Information',
    description:
        'This is an informational message to provide you with important details.',
    alertType: V3CAlertType.info,
    okOnPress: () {
      setState(() {
        _lastAction = 'Info alert - Acknowledged';
      });
    },
    cancelOnPress: () {
      setState(() {
        _lastAction = 'Info alert - Dismissed';
      });
    },
  ).show();
}

For a complete example, see the example project.

Roadmap

• Custom themes: Allow users to customize the look and feel of alerts completely.
• Additional animations: Provide more built-in animations options.

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for details.

License

Distributed under the MIT License. See LICENSE for more information. © 2025 V3 Code Studio. All rights reserved.