high_q_notifications

A Flutter package that handles push notifications efficiently using Firebase Messaging and local notifications. Supports background message handling, scheduling notifications, and offers utilities for timezone management and dependency injection.

---

🚀 Installation

Quickest way to add the package and enable the CLI:

flutter pub add high_q_notifications
dart pub global activate high_q_notifications
dart run high_q_notifications:setup_notifications

---

🛠️ What the CLI does

When you run the CLI tool:

dart run high_q_notifications:setup_notifications

It performs the following actions automatically:

• Creates essential notification-related files inside lib/notification_service/:

  • configs/android_config.dart
  • configs/ios_config.dart
  • utils/navigation_service.dart
  • utils/handle_navigation.dart
  • utils/notifications_type.dart
  • exports.dart

• Sets up a main_copy.dart file to demonstrate how to integrate HighQNotifications into your app.

• Ensures your project is ready to handle:

  • Firebase messages
  • Background taps
  • Local notifications

---

🔊 Custom Sound Support (Important)

To use custom notification sounds, you must manually add the sound files to the correct platform folders:

✅ Android

• Place your .mp3 sound file inside:

  android/app/src/main/res/raw/
  

• Example:

  android/app/src/main/res/raw/notification_sound.mp3
  

✅ iOS

• Place your .caf sound file inside:

  ios/Runner/Resources/
  

• Example:

  ios/Runner/Resources/notification_sound.caf
  

---

📦 Using the CLI tool

This package provides a command line interface (CLI) tool for setup and management.

Run the CLI command directly in your project:

dart run high_q_notifications:setup_notifications

---

(Optional) Using CLI globally

To activate the CLI globally on your machine:

dart pub global activate high_q_notifications

Then use the command like this:

high_q_notifications:setup_notifications

---

📋 Summary

Use case	Command
Add package to Flutter app	flutter pub add high_q_notifications
Run CLI tool in project	dart run high_q_notifications:setup_notifications
Activate CLI globally	dart pub global activate high_q_notifications

---