medium complexity extracted Home & Navigation Confidence: 100%
6
Components
106
Shared
0
User Stories
Yes
Analyzed

Description

The Role-Specific Home Dashboard provides a personalized entry point for every user of the Meander Mobile App, dynamically adapting its content and quick-access widgets based on the authenticated user's role (Peer Mentor or Coordinator). Peer Mentors see their recent activities, upcoming follow-ups, and a quick-log shortcut, while Coordinators see team overviews, pending approvals, and assignment dispatches. The dashboard acts as the operational nerve center, surfacing the most contextually relevant information and actions without requiring navigation deeper into the app.

User Flow

Role-Specific Home Dashboard user flow
Click to expand

Analysis

Business Value

A role-tailored home screen is foundational to achieving the project's core design principle of minimizing cognitive load. Peer Mentors — many of whom have beginner-level digital skills or cognitive accessibility needs — must arrive at a screen that immediately shows what they need to do next, without hunting through menus. Coordinators require a different operational view to manage their teams efficiently. By surfacing role-appropriate content at launch, the app dramatically reduces time-to-first-action, increases daily engagement, and reduces support requests stemming from user confusion. This is the first screen users see every session, making its quality and relevance a direct driver of adoption and retention across all four partner organizations.

Implementation Notes

Implemented in Flutter using BLoC for state management, with the home screen widget tree branching on the authenticated role retrieved from the local token/permission store. Role detection is performed at app startup via the Auth BLoC, and the home screen subscribes to the appropriate BLoC streams (ActivityBloc, AssignmentBloc, TeamStatsBloc) depending on role. All dynamic content is fetched from the REST API on mount with a stale-while-revalidate strategy; cached data from local SQLite is shown immediately while fresh data loads. WCAG 2.2 AA compliance requires all stat cards and action buttons to meet 24×24 minimum touch target size and 4.5:1 contrast ratios. The dashboard layout uses a single-column vertical scroll pattern to support accessibility and avoid swipe-based navigation.

Components (112)

User Interface (2)

Service Layer (2)

Data Layer (1)

Infrastructure (1)

Shared Components

These components are reused across multiple features

Service Layer (34)

Data Layer (22)

Infrastructure (38)

infrastructure Keychain/Keystore Adapter low Shared infrastructure JWT Claims Extractor low Shared infrastructure Organization Labels Adapter low Shared infrastructure Keychain/Keystore Adapter low Shared infrastructure Auth API Client medium Shared infrastructure REST API Client medium Shared infrastructure WCAG Accessibility Adapter low Shared infrastructure Registration API Client low Shared infrastructure Accounting API Client high Shared infrastructure PDF Renderer Adapter medium Shared infrastructure File Share Adapter low Shared infrastructure FCM/APNs Adapter high Shared infrastructure Share Sheet Adapter low Shared infrastructure Share Plus Adapter low Shared infrastructure Platform Accessibility Bridge medium Shared infrastructure Semantics Override Adapter high Shared infrastructure URL Launcher Adapter low Shared infrastructure Markdown Content Renderer low Shared infrastructure Network Connectivity Monitor low Shared infrastructure Expense Receipt Storage Adapter low Shared infrastructure Audit Log Writer low Shared infrastructure Feature Flag Checker low Shared infrastructure Logo Upload Adapter low Shared infrastructure Terminology Constants Registry low Shared infrastructure Feature Flag Cache Adapter low Shared infrastructure Org Scope JWT Resolver medium Shared infrastructure Association Audit Logger low Shared infrastructure Token Blocklist medium Shared infrastructure Analytics Tracker low Shared infrastructure SEO Metadata Config low Shared infrastructure Analytics Tracker low Shared infrastructure Analytics Tracker low Shared infrastructure Sales Analytics Tracker low Shared infrastructure Email Provider Adapter low Shared infrastructure Terms of Service Content Provider low Shared infrastructure Legal PDF Asset Provider low Shared infrastructure Consent-Gated Script Loader low Shared infrastructure Legal Page Layout low Shared

User Stories

No user stories have been generated for this feature yet.