Event Listing
Feature Detail
Description
Event Listing presents users with a browsable, filterable list of upcoming and past events within their organization. The screen displays key event metadata - title, date, time, location, and participant count - in a scannable card layout. Users can filter by date range or status and tap any event card to navigate to the event detail and sign-up flow. The list is fetched from the REST API and cached locally to support offline browsing of previously loaded events.
User Flow
Analysis
A clear, well-organized event listing ensures that peer mentors and coordinators are aware of planned activities and can coordinate participation without relying on manual communication. Visibility into upcoming events increases attendance rates and reduces the coordinator overhead of individually notifying participants. The listing also serves as an audit trail of organizational activity, supporting Bufdir reporting and giving organization administrators confidence that events are being recorded and tracked consistently across the platform.
The Event List Screen uses a BLoC-driven Flutter ListView with pagination, fetching events from the GET /api/v1/events endpoint filtered by organization context derived from the user's JWT claims. The Event Query Service handles sorting, filtering, and cursor-based pagination. Results are cached in the local SQLite Event Repository for offline access. Cards display title, date, time, location, and a participant count badge. WCAG 2.2 AA compliance is maintained through semantic list semantics, adequate contrast, and touch targets meeting the 24x24 minimum requirement.
Components (37)
Shared Components
These components are reused across multiple features
Service Layer (9)
Data Layer (12)
Infrastructure (7)
User Stories
No user stories have been generated for this feature yet.