Contact List & Search

Contact management is a foundational capability for peer mentors - without fast access to their contact list, every activity registration and follow-up interaction is slowed down. A searchable list dramatically reduces the time spent locating a specific person, which is especially important for coordinators managing large numbers of peer mentors and contacts across multiple local chapters. For organizations like NHF with up to 1,400 local chapters, efficient contact lookup directly reduces the cognitive load on users with limited digital skills. The feature also supports compliance by ensuring coordinators always work with the correct contact record, reducing the risk of logging activities against the wrong person. This is identified as a must-have ("Basic search") across all four workshop organizations.

The contact list is backed by a Drift query on the local SQLite database, with a reactive stream that rebuilds the list on any local data change. Search is implemented as a client-side filter on the cached dataset using case-insensitive substring matching on name fields, avoiding unnecessary API calls for each keystroke. The Riverpod provider exposes a combined state of the full list and the current search query, with the filtered view derived reactively. Role-based filtering is applied at the provider level: peer mentors see only their assigned contacts, coordinators see contacts across their local chapter. Pagination or lazy loading should be considered for coordinators managing large contact sets. The UI uses the shared AppTextField widget for search input and a ListView.builder for efficient rendering. All list items must meet WCAG 2.2 AA touch target and contrast requirements.