Home Screen
Use the Home Screen to set coverage and search context and to start a provider search.
This screen supports both authenticated and unauthenticated users and supports location input with or without device permission.
Access requirements
This screen supports authenticated and unauthenticated sessions.
This screen includes
- A top app bar with a menu icon and brand header.
- A coverage selector (for example, Private) when coverage options exist.
- A member selector when covered members exist.
- A location input that accepts a city, region, or postal area (for example, 75001 Paris, France).
- A need input that accepts free text (for example, Type your need) when the expanded search layout displays.
- A specialty grid that lists available specialties (for example, Video (online), General Doctor, Dentist, Orthopedist).
- A bottom navigation bar that links to Find a doctor, Account, Appointments, and Contact.
- A contextual banner area that shows one of the following states when applicable:
- An appointment status prompt (for example, You have an appointment).
- A feedback prompt (for example, Please rate your last experience).
Workflow
| Session state | Location state | Screenshot | App behavior |
|---|---|---|---|
| Logged in | Without location |  | Displays coverage and member selectors when available. Displays the location-first layout and disables location-dependent search actions. |
| Logged in | With location |  | Displays coverage and member selectors when available. Prefills location when permission exists. Displays the expanded search layout with the need input and specialty grid. |
| Logged out | Without location |  | Displays the search entry layout without account-specific selectors. Displays the location-first layout and disables location-dependent search actions. |
| Logged out | With location |  | Displays the search entry layout without account-specific selectors. Prefills location when permission exists. Displays the expanded search layout with the need input and specialty grid. |
Actions
Screen behavior reflects user selection and validation state.
| Scenario | App behavior |
|---|---|
| User selects a coverage option. | Applies the coverage filter to the search context. |
| User selects a member. | Applies the member filter to the search context. |
| User enters a location. | Applies the location to the search context and updates available specialties. |
| User selects a specialty tile. | Opens the Provider List screen with the active search context. |
| User selects a bottom navigation item. | Opens the selected destination screen. |
Validations
These scenarios describe how the app validates state and input on the Home Screen.
| Scenario | App behavior | Failure impact |
|---|---|---|
| Location input is empty or unsupported. | Displays an inline validation error and blocks location-dependent search actions. | The user cannot proceed to specialty selection or provider search. |
| Location input contains a supported value. | Enables specialty selection and search actions. | None. The user can continue the flow. |
| Specialty availability changes. | Disables unavailable specialties based on coverage rules, regional limits, or configuration flags. | The user cannot select disabled specialties. |
| Completed visit exists. | Displays the feedback prompt. | None. Feedback remains optional. |
| Completed visit does not exist. | Hides the feedback prompt. | None. No feedback option appears. |
Endpoint Resources
🧰 Endpoint Resources under construction