Navigate from Notification Deep Link to Correct In-App Screen
Every push notification dispatched by the system must carry a deep link payload that resolves to a specific in-app route. The deep link handler must support at minimum: contact detail, assignment detail, certification status, notification centre, and scenario prompt detail. When the app is closed and a notification is tapped, the app must cold-start and navigate directly to the deep-linked screen after authentication. When the app is in the background and a notification is tapped, the app must foreground and navigate to the screen without triggering a full reload. The deep link handler must be role-aware to prevent mentors from accidentally accessing coordinator-only screens via a mis-configured notification.
User Story
Acceptance Criteria
- Given a push notification with a contact deep link is tapped while the app is closed, when the app launches and authentication completes, then the contact detail screen for the specified contact is displayed
- Given a push notification is tapped while the app is in the background, when the app foregrounds, then the user is navigated to the linked screen without re-authenticating
- Given a notification deep link points to a coordinator-only screen, when a peer mentor taps it, then they are redirected to a role-appropriate fallback screen and shown an informational message
- Given a notification references an entity that no longer exists (e.g., a deleted assignment), when the deep link resolves, then a user-friendly error message is shown rather than a crash or blank screen
- Given the user navigates back from a deep-linked screen, when they press back, then they reach the notification centre or the appropriate parent screen in the navigation stack rather than exiting the app
Business Value
Deep linking is the feature that transforms push notifications from simple awareness alerts into actionable workflow triggers. Without correct deep linking, a mentor must dismiss a notification, open the app, and manually navigate to the relevant content — a multi-step process that dramatically reduces follow-through rates. Correct deep linking ensures every notification results in the highest probability of the mentor taking the intended action.
Components
- Notification Deep Link Handler service
- Notification Deep Link Handler service
- Scenario Deep Link Handler service
- Scenario Deep-Link Router service
- Deep Link / OAuth Redirect Handler infrastructure
- Deep Link / OAuth Redirect Handler infrastructure
- Notification BLoC service
- Role-Aware Notification Filter Service service