Skip to main content

Home Screen

Use the Home Screen to define search context and start provider discovery.


note

Supports authenticated and unauthenticated sessions.

This screen includes:

  • Top header

    • Brand logo
    • Location selector
    • Coverage selector
    • Member selector

  • Service selection section

    • Service tiles (for example: Video, General doctor, Dentist, Pediatrician, Gynecologist, Orthopedist)
    • See all action

  • First available doctor section

    • Informational card
    • Primary action to request the first available doctor

  • Highly available doctors section

    • Doctor cards with:
      • Name
      • Specialty
      • Rating

  • Footer branding

    • “Operated by Air Doctor” indicator

  • Bottom navigation

    • Home (active)
    • Appointments
    • Account
    • Contact

Workflow​

  1. Open the Home Screen.
  2. Select coverage and member when available.
  3. Enter or confirm location.
  4. Enter a search term or select a service.
  5. Open the Doctor List with the current context.

Validations​

ScenarioApp behaviorSDK output
Location missingDisable search and service selectionMissing location state
Location invalidDisplay error and block progressionInvalid location state
Location availableEnable discovery and servicesLocation context ready
Location permission grantedPrefill locationLocation resolved
Coverage selectedRestrict services and availabilityCoverage constraint applied
Coverage updatedRefresh available contentUpdated coverage state
Providers availableDisplay services and doctorsAvailability dataset returned
Providers unavailableHide or disable servicesEmpty availability state
User authenticatedDisplay coverage and member selectorsUser context available
User unauthenticatedHide account-specific controlsGuest state
Video-only availabilityRestrict booking to videoVideo-only state
Unsupported locationBlock bookingUnsupported location state

Actions​

ScenarioApp behaviorSDK output
Coverage selectedUpdate coverage contextcoverage = updated
Member selectedUpdate member contextmember = updated
Location entered or changedUpdate location and refresh availabilitylocation = updated
Search input enteredUpdate query and suggestionsquery = updated
Service selectedNavigate to Doctor List with contextcontext = submitted
Bottom navigation selectedSwitch top-level screenactiveRoute = <destination>
Side navigation openedDisplay navigation panelpanel = open

Endpoint Resources​

PUT 

Home Screen for Patient​

/v3/home

Produces the home screen for patient.