🛡️ Zeb Permissions Helper #

A clean, customizable, and developer-friendly way to handle permissions in Flutter.

💖 Support the Project #

If this package helps you, please consider:

• ⭐ Star the repo on GitHub: zeb_permissions_helper
• 💙 Like the package on pub.flutter-io.cn: pub.flutter-io.cn/packages/zeb_permissions_helper

Your support motivates continued improvements and maintenance!

🚀 Overview #

Zeb Permissions Helper simplifies handling app permissions in Flutter with:

• Unified API across packages (permission_handler, location, flutter_local_notifications)
• Customizable dialogs and messages
• Sequential permission requests
• Configurable fallback and override behavior
• Graceful handling of permanently denied permissions

📦 Installation #

Add the dependency in your pubspec.yaml:

dependencies:
  zeb_permissions_helper: ^1.1.2

Then run:

flutter pub get

🧠 Key Features #

🧩 Supported Permissions #

📦 Supported Packages #

💡 Usage Examples #

1️⃣ Request a single permission #

final helper = ZebPermissionsHelper();

final result = await helper.requestPermission(
  context,
  ZebPermission.camera,
);

if (result.isGranted) {
  print("Camera permission granted!");
} else {
  print("Camera permission denied or permanently denied.");
}

2️⃣ Request with custom purpose dialog text #

final result = await helper.requestPermission(
  context,
  ZebPermission.microphone,
  requestConfig: SingleRequestConfig(
    dialogText: const DialogText(
      title: "Microphone Access",
      explanation: "We need access so you can talk during calls.",
      caution: "Please enable the microphone in settings for calls.",
    ),
  ),
);

3️⃣ Request multiple permissions sequentially #

final results = await helper.requestPermissionsSequentially(
  context,
  sequentialConfig: SequentialRequestConfig(
    permissions: [
      ZebPermission.camera,
      ZebPermission.microphone,
      ZebPermission.locationWhenInUse,
    ],
    delayBetweenRequests: const Duration(milliseconds: 500),
  ),
);

for (final res in results) {
  debugPrint("${res.permission} → Granted: ${res.isGranted}");
}

4️⃣ Customize default texts and behaviors #

final config = ZebPermissionsConfig(
  showDialogsByDefault: true,
  defaultPackage: PermissionPackage.permissionHandler,
  overrides: {
    ZebPermission.notification: AppPermissionData(
      permission: ZebPermission.notification,
      dialogText: const DialogText(
        title: "Allow Notifications",
        explanation:
            "Stay up to date with real-time order and chat alerts.",
        caution:
            "Notifications are disabled. Please enable them in Settings.",
      ),
    ),
  },
);

final helper = ZebPermissionsHelper(config: config);

5️⃣ Check if a permission is already granted #

final isGranted =
    await helper.isPermissionGranted(ZebPermission.locationAlways);

if (isGranted) {
  print("Location Always permission already granted!");
}

🧩 Custom Permanently Denied Dialog (Advanced) #

You can fully override the default “Open Settings” dialog by providing a custom builder:

final helper = ZebPermissionsHelper(
  config: ZebPermissionsConfig(
    permanentlyDeniedDialogBuilder: (context, data, onOpenSettings) {
      return AlertDialog(
        title: Text("Custom ${data.permission.name} Dialog"),
        content: Text(data.dialogText.caution),
        actions: [
          TextButton(
            onPressed: onOpenSettings,
            child: const Text("Go to Settings"),
          ),
        ],
      );
    },
  ),
);

⚙️ Utility Helpers #

🧪 Example Project #

You can check a working example in the example/ directory. It demonstrates requesting multiple permissions with custom dialogs and configurations.

🤝 Contributing #

We’d love your help to make Zeb Permissions Helper even better! Here’s how you can contribute:

1. 🍴 Fork the repository
2. 🧩 Create a feature or fix branch (feature/my-new-feature)
3. 🧪 Add tests and run flutter test
4. 🧾 Commit your changes (git commit -m "Add new feature")
5. 🚀 Push to your branch and create a Pull Request

📜 License #

This package is licensed under the MIT License. See the LICENSE file for details.

💬 Credits #

Developed with ❤️ by Sufi Aurangzeb Hossain

Simplifying permission handling for every Flutter app. “Great code is not about complexity — it’s about clarity.”