📦 zeba_academy_notification_scheduler

A powerful, lightweight Flutter package for offline local notification scheduling with support for repeating alerts, customization, and easy integration.

🚀 Features

  • 🔔 Offline local notifications (no internet required)
  • ⏰ Schedule one-time or repeating notifications
  • 🔁 Daily & weekly repeating support
  • 🎨 Custom icons, sounds, and vibration patterns
  • 📊 Notification grouping & priority control
  • ⚡ Simple and clean API for fast integration
  • 🧠 Timezone-aware scheduling

📦 Installation

Add this to your pubspec.yaml:

dependencies:
  zeba_academy_notification_scheduler: ^0.0.1

Then run:

flutter pub get

⚙️ Setup

🔹 Initialize Notifications

await ZebaNotificationService.init();
await TimezoneHelper.init();

🧪 Basic Usage

🔹 Create Notification

final notification = ZebaNotification(
  id: 1,
  title: "Reminder",
  body: "Time to study Flutter!",
  scheduledTime: DateTime.now().add(Duration(seconds: 10)),
);

🔹 Schedule Notification

await ZebaScheduler.schedule(notification);

🔁 Repeating Notifications

✅ Daily

final notification = ZebaNotification(
  id: 2,
  title: "Daily Reminder",
  body: "Stay consistent!",
  scheduledTime: DateTime.now().add(Duration(seconds: 10)),
  repeatDaily: true,
);

✅ Weekly

final notification = ZebaNotification(
  id: 3,
  title: "Weekly Reminder",
  body: "Weekly check-in!",
  scheduledTime: DateTime.now().add(Duration(seconds: 10)),
  repeatWeekly: true,
);

❌ Cancel Notifications

Cancel one

await ZebaScheduler.cancel(1);

Cancel all

await ZebaScheduler.cancelAll();

🎨 Advanced Customization

🔊 Custom Sound

AndroidNotificationDetails(
  'zeba_channel',
  'Zeba Notifications',
  sound: RawResourceAndroidNotificationSound('custom_sound'),
);

📳 Vibration Pattern

vibrationPattern: Int64List.fromList([0, 1000, 500, 1000]),

📦 Group Notifications

groupKey: 'zeba_group',

📱 Platform Setup

🤖 Android

Add permissions in AndroidManifest.xml:

<uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>

🍎 iOS

Enable notification permissions in AppDelegate.swift:

UNUserNotificationCenter.current().requestAuthorization(
  options: [.alert, .badge, .sound],
  completionHandler: { _, _ in }
)

🧠 Important Notes

  • Always initialize timezone before scheduling
  • Use unique notification IDs
  • Scheduled notifications persist after app restart (Android)
  • Works completely offline

🎯 Use Cases

  • 📅 Reminder apps
  • ⏰ Alarm systems
  • 📢 Offline alert systems
  • 📚 Study planners
  • 💼 Productivity tools

🧪 Testing

Make sure to initialize timezone in tests:

setUpAll(() {
  tz.initializeTimeZones();
});

🤝 Contributing

Contributions are welcome! Feel free to open issues or submit pull requests to improve this package.

📄 License

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

👨‍💻 About Me

✨ I’m Sufyan bin Uzayr, an open-source developer passionate about building and sharing meaningful projects. You can learn more about me and my work at sufyanism.com or connect with me on LinkedIn

🌐 Your all-in-one no-bloat hub!

🚀 Explore cutting-edge resources in coding, tech, and development at zeba.academy and code.zeba.academy.

Empower yourself with practical skills through curated directives, real-world projects, and hands-on experience. Level up your tech game today! 💻✨

Zeba Academy is a learning platform dedicated to coding, technology, and development.

➡ Visit our main site: https://zeba.academy ➡ Explore courses: https://code.zeba.academy ➡ YouTube: https://www.youtube.com/@zeba.academy ➡ Instagram: https://www.instagram.com/zeba.academy/

Thank you for visiting! ❤️

Libraries

zeba_academy_notification_scheduler