💤 in_app_idle_detector #

A lightweight Flutter plugin that detects user inactivity (idle state) across all platforms: Android, iOS, Web, Windows, macOS, and Linux.

Perfect for banking apps, secure dashboards, or any app that needs to react when the user goes idle.

✨ Features #

• 🔄 Detect inactivity after custom timeout
• 👨‍💻 Keyboard, mouse, touch & app lifecycle supported
• 🖥️ Cross-platform (Android, iOS, Web, Desktop)
• ⏱️ Remaining time tracking
• 🛠️ Lightweight – no native code
• 🔐 Ideal for auto logout, lock screen, and productivity

📦 Installation #

dependencies:
  in_app_idle_detector: ^0.0.1

Working Demo #

🧑‍💻 Usage #

1. Initialize the plugin (e.g. inside main())

void main() {
  runApp(MyApp());

  InAppIdleDetector.initialize(
    timeout: Duration(seconds: 10), // Set your own duration
    onIdle: () {
      // Called when user goes idle
      print("User is idle");
    },
    onActive: () {
      // Called when user becomes active again
      print("User is active");
    },
  );
}

2. Show a dialog or take action on idle

showDialog(
  context: navigatorKey.currentContext!,
  builder: (_) => AlertDialog(
    title: Text("Idle Warning"),
    content: Text("You've been inactive for 10 seconds."),
    actions: [
      TextButton(
        onPressed: () {
          Navigator.of(navigatorKey.currentContext!).pop();
        },
        child: Text("Dismiss"),
      ),
    ],
  ),
);

3. Extra API (Pause / Resume / Reset)

InAppIdleDetector.pause();  // Stop tracking temporarily
InAppIdleDetector.resume(); // Resume tracking
InAppIdleDetector.reset();  // Manually reset idle timer

4. Get Remaining Time

final timeLeft = InAppIdleDetector.remainingTime;
final idleStatus = InAppIdleDetector.isIdle;

✅ Use Cases #

🔒 Auto-logout after inactivity (e.g., in banking apps)

🔐 Lock screen on desktops after idle

⏱️ Countdown timers for session expiration

📉 Inactivity analytics and user behavior tracking

🧪 Platform Support #

📚 API Summary #

Method Description initialize(...) Starts the idle detection system reset() Resets the timer (e.g. after activity) pause() Temporarily disables tracking resume() Resumes tracking isIdle Returns true if currently idle remainingTime Returns Duration until next idle trigger

💡 Tips #

Always use navigatorKey.currentContext for dialogs to ensure it works from anywhere. You can build a visual countdown using remainingTime and a Timer.periodic.

Support the Project #

If you find this plugin helpful, consider supporting its development:

• Buy Me a Coffee

Your support is greatly appreciated!

Bugs/Requests #

Feel free to open an issue if you encounter any problems or think that the plugin is missing some feature.

sheth02parth1299@gmail.com

🙌 Author #

Created by Parth Sheth 🧠 Contributions, stars, and feedback are welcome!