Implement Push Notifications System

[RUKAYAT-CODER]

Overview

Set up push notifications for course updates, messages, and learning reminders.

Background

Push notifications are essential for user engagement and timely communication on mobile.

Specifications

Notification Types:

• Course updates and new content
• Message notifications
• Learning reminders
• Achievement unlocks
• Community activity

Tasks:

• Configure Firebase Cloud Messaging
• Implement notification permission handling
• Create notification handlers for each type
• Add notification preferences settings
• Implement deep linking from notifications

Impacted Files:

• src/services/pushNotifications.ts (new)
• src/hooks/useNotificationPermission.ts (new)
• src/components/mobile/NotificationPrompt.tsx (new)
• src/utils/notificationHandlers.ts (new)
• capacitor.config.ts (update)

Labels: mobile, notifications, push, fcm, priority-high

Acceptance Criteria

• Notifications work on iOS and Android
• Permission request is user-friendly
• Deep links open correct app screens
• Notification preferences are respected
• Badge counts update correctly
  For me info check the project repo here

[drips-wave]

This issue has been added to the Stellar Wave Program and is worth 200 Points.

🧑‍💻 Interested in contributing? Apply to work on this issue on Drips Wave, earn points, and receive rewards.

🤠 Repo maintainers: You can manage this issue's Points and Complexity on your Maintainer Dashboard here. Please keep an eye on applications and respond quickly 💙

ℹ️ Learn more about Drips Wave

[rosemary21]

@rosemary21 has applied to work on this issue as part of the Stellar Wave Program's 1st wave.

I’d like to work on this issue because push notifications are a core driver of engagement in mobile learning apps, and this task covers the full lifecycle—from permissions and delivery to deep linking and user preferences. It’s especially appealing because it combines mobile UX, platform integration, and clean application architecture, all of which are critical for a high-quality user experience.

This issue also stands out as high-impact: timely course updates, reminders, and achievements can significantly improve learning consistency and retention when implemented thoughtfully and respectfully.

Relevant Experience

Firebase Cloud Messaging (FCM)

Configured FCM for both iOS and Android in hybrid and native mobile apps

Handled token registration, refresh, and backend synchronization

Implemented foreground, background, and terminated-state notification handling

Notification Permissions & UX

Built user-friendly permission flows that delay prompts until clear value is shown

Implemented reusable hooks (e.g., permission status tracking and re-request logic)

Experience aligning permission prompts with platform guidelines (iOS/Android)

Notification Handling & Routing

Implemented structured notification payloads and type-based handlers

Created deep-linking logic to route users to the correct app screen from a notification

Safely handled edge cases (app cold start, missing context, expired content)

User Preferences & Settings

Designed notification preference systems (opt-in/opt-out per category)

Ensured preferences are respected at both client and delivery levels

Experience syncing preferences with backend APIs

Capacitor & Mobile Tooling

Worked with Capacitor configuration and plugins for push notifications

Comfortable updating capacitor.config.ts and integrating platform-specific settings

ℹ️ Repo Maintainers: To accept this application, review their application or assign @rosemary21 to this issue.

[drips-wave]

Congratulations, @rosemary21! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on January 31, 2026.

🧑‍💻 @rosemary21: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

⚠️ Important: When opening a PR, please link it to this issue to ensure it gets tracked accurately.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊

[drips-wave]

This issue has been completed by @rosemary21 as part of the Stellar Wave Program's 1st Wave 🥳

😎 @rosemary21: You earned 200 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here.

🧑‍💻 Repo maintainers: How'd the contributor do? If you like, you can reward them with additional points by making a compliment within seven days after the Wave Program's current wave ends.

[drips-wave]

@rosemary21 received 2 compliments:

• Problem Solver: +50 points
• Good Communicator: +50 points