tap2exit #

A Flutter plugin providing double-tap-to-exit functionality for Android with native Toast support and safe iOS handling.

Features #

• 🔙 Intercepts back button presses — shows a message on the first press, exits on the second.
• ⏱️ Configurable time window for the double-tap detection.
• 💬 SnackBar message by default — fully customisable style.
• 📱 Optional native Android Toast via a simple boolean flag.
• 🍎 Safe no-op on iOS — no app rejection risk.
• 🎯 Exit callback for cleanup before the app closes.
• 📦 Zero external dependencies.

Installation #

Add tap2exit to your pubspec.yaml:

dependencies:
  tap2exit: ^1.2.0

Then run:

flutter pub get

Quick Start #

Wrap your top-level page widget with Tap2Exit:

import 'package:tap2exit/tap2exit.dart';

@override
Widget build(BuildContext context) {
  return Tap2Exit(
    child: Scaffold(
      appBar: AppBar(title: const Text('My App')),
      body: const Center(child: Text('Hello!')),
    ),
  );
}

Parameters #

Advanced Usage #

Custom SnackBar Styling #

Tap2Exit(
  snackBarStyle: Tap2ExitSnackBarStyle(
    backgroundColor: Colors.black87,
    textStyle: const TextStyle(color: Colors.white, fontSize: 16),
    behavior: SnackBarBehavior.floating,
    shape: RoundedRectangleBorder(borderRadius: BorderRadius.circular(12)),
    margin: const EdgeInsets.all(16),
  ),
  child: MyHomePage(),
)

Native Toast on Android #

Tap2Exit(
  useToast: true,
  child: MyHomePage(),
)

Exit Callback #

Tap2Exit(
  onExit: () async {
    await saveUserData();
    debugPrint('Goodbye!');
  },
  child: MyHomePage(),
)

Platform Behaviour #

Example #

A fully working example app is included in the example/ directory. Run it with:

cd example
flutter run

License #

MIT — see LICENSE for details.