User Interface low complexity mobile
1
Dependencies
0
Dependents
0
Entities
1
Integrations

Description

Overlay card displayed when a mentor marker is tapped, showing name, specializations, and availability. Includes a deep link button navigating to the full peer mentor detail screen. Dismissible via tap-outside or close button.

Feature: Geographic Peer Mentor Map View

mentor-info-popup

Summaries

The Mentor Info Popup Card delivers the critical first moment of connection between students and peer mentors, directly influencing whether a student chooses to engage with the mentoring program. By surfacing a mentor's name, specializations, and live availability at a glance — without leaving the map — the product removes friction from discovery and increases conversion to mentor bookings. This lightweight interaction reduces drop-off at the most vulnerable point in the user journey, protecting program participation rates and the platform's core value proposition of accessible peer support.

This is a low-complexity UI component with a single upstream dependency on the map-marker-widget, making it straightforward to schedule after the marker widget is stable. Implementation is self-contained and suitable for a junior-to-mid developer within a single sprint. Key delivery risk is coordinate handling between the marker tap event and the popup positioning logic on varying screen sizes. Testing must cover dismissal flows (tap-outside, close button) and deep-link navigation to the mentor detail screen.

No backend work required; data is passed directly from the parent map screen.

Mentor Info Popup Card is a stateless overlay widget receiving a PeerMentor model via show(). It exposes onViewDetailTapped(String mentorId) for deep-link navigation upstream and dismiss() for programmatic close. It depends on map-marker-widget to receive tap events and the PeerMentor data model for display. Implementation should use a Stack or Overlay entry pattern to position the card above the map layer without disrupting the gesture detector.

Tap-outside dismissal requires a full-screen GestureDetector behind the card. Ensure the widget lifecycle cleans up overlay entries to prevent memory leaks on navigation.

Responsibilities

  • Show mentor summary data on marker tap
  • Provide navigation link to peer mentor detail screen
  • Support dismiss via tap-outside or close button

Interfaces

show(PeerMentor mentor)
dismiss()
onViewDetailTapped(String mentorId)
build(BuildContext context)

Relationships

Dependencies (1)

Components this component depends on

Used Integrations (1)

External integrations and APIs this component relies on