zeba_books_offline_gatekeeper

Security and integrity suite for offline educational and proctoring applications built with Flutter.

This plugin helps developers enforce secure exam environments by detecting background usage, preventing screenshots, enforcing offline mode, and protecting sensitive student data.

---

✨ Features

• ✅ App Lifecycle monitoring (foreground/background detection)
• ✅ Screen recording & screenshot protection (Android secure flag)
• ✅ FocusLock multi-window / split-screen detection
• ✅ Encrypted secure local storage
• ✅ Connectivity monitoring for offline enforcement
• ✅ Designed for educational & proctoring apps

---

📦 Installation

Add dependency:

dependencies:
  zeba_books_offline_gatekeeper: ^0.0.1

Run:

flutter pub get

---

🚀 Usage

Import:

import 'package:zeba_books_offline_gatekeeper/zeba_books_offline_gatekeeper.dart';

---

Lifecycle Monitoring

final lifecycle = LifecycleMonitor()
  ..onChanged = (state) {
    print(state);
  };

lifecycle.start();

---

Enable Screen Protection

await ScreenGuard.enableSecureMode();

---

Focus Lock Detection

bool multiWindow = await FocusLock.isInMultiWindow();

---

Secure Storage

final storage = SecureGatekeeperStorage();

await storage.write("token", "secure_value");

final value = await storage.read("token");

---

Connectivity Monitoring

final monitor = ConnectivityMonitor();

monitor.offlineStream().listen((offline) {
  print("Offline: $offline");
});

---

📱 Android Permissions

Add required permissions inside AndroidManifest.xml.

---

🎯 Use Cases

• Online examinations
• Offline assessment apps
• Learning management systems
• Secure education platforms
• Proctoring solutions

---

📄 License

This project is licensed under the GNU General Public License v3.0 (GPL-3.0).

---

🤝 Contributions

Pull requests and improvements are welcome.

---