📦 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! ❤️