Notifications Setup

Notifications Setup

Operational guide for the mobile push stack. Architecture context: Realtime and Notifications.

Canonical source: docs/guide/NOTIFICATION_SETUP_GUIDE.md — this page summarizes it; the repo guide has the exact setup steps and file references.

The stack

• Firebase Cloud Messaging (FCM) for delivery + Notifee for local presentation/handling on the device.
• A yc:// deep-link scheme so a tapped notification routes to the right screen.
• A defined Android notification channel id for categorized delivery.

What the guide covers

• The libraries involved and how they fit together.
• Key entry-point files in apps/mobileAppYC that wire up registration, foreground/background handling, and deep-link routing.
• Step-by-step setup (permissions, channel creation, token registration).

How it connects to the backend

Push payloads originate from the backend's NotificationService, invoked directly by the mutation flows (there is no event bus today — the org-event bus in Realtime and Notifications is an unimplemented design). Heavier async sends (reminders, batched notifications) run on BullMQ workers — see Backend: Realtime, Chat, Jobs.

Related

• Realtime and Notifications · Realtime Setup · Mobile: Chat, Notifications, Adverse Events