🏠 Overview › 👥 User Roles ›📖 Navigate to Contact Detail via Deep-Link from Othe...

Navigate to Contact Detail via Deep-Link from Other Screens

The Contact Detail Screen supports deep-link navigation, meaning it can be opened directly from any screen that references a contact — including the activity log, assignment inbox, notification items, and the coordinator's member overview. The deep-link route is parameterised by contact ID and is handled by the App Router Service. On opening via deep-link, the screen renders the full contact profile as normal. The back button returns the user to the originating screen, preserving the scroll position and state of that screen. Deep-link support is critical for the coordinator's workflow of reviewing assignments and quickly cross-referencing contact details.

MEDIUM story-contact-detail-management-peer-mentor-008 2 pts
2
Story Points
Medium
Priority
Contact Detail & Management
Feature

User Story

As a user
I want to navigate directly to a specific contact's detail screen by tapping a contact reference in an activity log, assignment inbox, or notification, without having to search through the contacts list manually
So that So that I can move efficiently between related screens in my workflow — for example, going from an assignment dispatch directly to the contact it relates to — without losing context

Acceptance Criteria

  • Given a user taps a contact reference in the assignment inbox, when the navigation resolves, then the Contact Detail Screen for that contact opens with all fields populated
  • Given a user opens a contact via deep-link, when they tap the back button, then they are returned to the originating screen at the same scroll position
  • Given a deep-link references a contact ID that does not exist or the user does not have permission to view, when navigation is attempted, then a friendly error screen is shown with an option to return to the contacts list
  • Given a user opens a contact via deep-link while offline, when the detail screen loads, then cached data is displayed if available, otherwise an offline error state is shown
  • Given an activity log entry references a contact, when the user taps the contact name, then the Contact Detail Screen opens for that contact

Business Value

Deep-link navigation dramatically reduces the number of steps required to move between related records in a typical workflow. For coordinators who manage assignments and contacts simultaneously, the ability to jump from an assignment directly to the relevant contact eliminates manual searching and reduces the risk of confusing contacts with similar names. This directly addresses the coordinator pain point of managing large volumes of information across multiple screens efficiently.

Components

Contact Detail & Management
Related Feature
Peer Mentor (Likeperson)
User Role