Implement Push Notifications via Firebase (FCM)

[jamespepper81]

Implement robust cross-platform push notifications for the BitSleuth Wallet app using Firebase Cloud Messaging (FCM). These notifications will provide timely updates and key event alerts to app users, enhancing both usability and engagement. This work will span both client (React Native for Android/iOS) and backend integration, adopting best security practices and ensuring a high standard of reliability and configurability.

Scope and Requirements

• Firebase Project Setup:
  • Create and configure a dedicated Firebase project
  • Generate server key, client configuration, and service account as needed
• Client Integration:
  • Integrate FCM SDK for both Android and iOS in the React Native app
  • Implement OS-specific permission requests and fallback handling
  • For iOS: Set up APNs certificates/keys and enable notification capabilities
  • Add notification channels and categories with comprehensive foreground/background event handlers
• Backend Implementation:
  • Handle device token registration, secure storage, validation, and rotation upon refresh
  • Define and manage notification topics/segments (e.g., account, marketing, system)
  • Implement backend utilities to send both notification and data messages, with support for high-priority alerts
  • Secure API endpoints with environment variables and secret management
• Analytics & Reliability:
  • Integrate analytics to track delivery/open rates, opt-in/out status, and error logging
  • Add robust retry logic and error handling for failed sends
• Documentation and Testing:
  • Provide thorough documentation of setup, flows, and configuration
  • Write and execute a comprehensive test plan (covering both local and staging), including failure scenarios for delivery, opt-in/out, and device/token edge cases

Acceptance Criteria

• Seamless cross-platform push notification delivery (Android & iOS)
• Device tokens are securely handled and synchronized
• Users have granular control over notification topics and opt-in/out
• Analytics provide reliable delivery and open rate metrics
• Test cases cover opt-in/out, error and retry workflows, and APNs edge cases on iOS
• Documentation is clear and supports easy onboarding for future maintainers