> For the complete documentation index, see [llms.txt](https://fieldworker.gitbook.io/fieldworker-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://fieldworker.gitbook.io/fieldworker-docs/fundamentals/pages/home-page.md).

# Home Page

Starting (or a landing) page for each user. Your login page and its layout is determined by the business your company is in.

The Home Dashboard serves as the primary operational hub for care coordinators, administrators, and field staff. It consolidates scheduling, geospatial task verification, pending approvals, time tracking, and communication logs into a unified view. Depending upon the type of business, the features that your company has subscribed to, and your role, you will have a customized view of the application when you log in. This document provides an overview of key screens and their features.

<details>

<summary>For a Case management company</summary>

Case management is a collaborative process that helps patients and their families navigate the healthcare system to receive the support and services they need. The Fieldworker landing page allows case managers and their admins easy access to tools and functionalities to help their consumers achieve their goals.

</details>

<details>

<summary>For a Support Coordination company</summary>

[**The Supports Program**](http://www.state.nj.us/humanservices/ddd/programs/supports_program.html) is a Medicaid waiver program through which adults (21 and older) with intellectual and developmental disabilities who live in a non-licensed setting (typically a family member’s home) can access state services through the [New Jersey Division of Developmental Disabilities](http://www.state.nj.us/humanservices/ddd/home/) (DDD). &#x20;

A **support coordination agency** is a DDD funded service that assists individuals in gaining access to needed programs and state services, as well as needed medical, social, educational and other services.

</details>

<details>

<summary>For a Care provider company</summary>

A licensed person or organization that provides health care services. Examples of health care providers include doctors, nurses, therapists, pharmacists, laboratories, hospitals, clinics, and other healthcare centers.

</details>

<details>

<summary>For a Daycare Center</summary>

Daycare centers for disabled adults, also known as adult day service centers, provide a variety of services to help older adults and people with disabilities live independently and participate in the community:&#x20;

* **Socialization** - Adult day care centers provide opportunities for socialization with peers and other community members.&#x20;
* **Health and personal care** - Adult day care centers may offer medical services such as physical therapy, occupational therapy, or speech therapy.&#x20;
* **Activities** - Adult day care centers offer a variety of activities, including meals, recreation, and outings.&#x20;
* **Transitional care** - Adult day care centers may provide transitional care and short-term rehabilitation after hospital discharge.&#x20;
* **Relief for caregivers** - Adult day care centers provide relief for family members and caregivers by allowing them to go to work or run errands.&#x20;

</details>

## Home page

Here is an example of the landing page for an administrator of a New Jersey-based Support Coordination agency. The page provides access to all functionality subscribed to, and is useful for maximum benefit to a Support Coordination agency.

The landing pages for all users share a common structure, with all functionality organized into five areas.

The top left corner has controls to log out from the app, and a quick way to check 'What is new' in the current version of the app.

The left menu bar contains all functionality that your agency has subscribed to, including all core functionality that the app offers.

The top-right corner contains icons or buttons to access common, core functionality provided by the app, available to most users.

The main section of the screen contains all the detailed functionality that is most useful for your agency. This area is usually divided into two or more sections providing easy access to key functionality or summary information.

<figure><img src="https://1895083124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFKFmA5xK4sMCcp1WP4Kc%2Fuploads%2F6bgp1FDecgQUiLETx320%2FScreen%20Shot%202026-08-16%20at%201.19.09%20AM.png?alt=media&amp;token=136646bc-aea4-4beb-83e7-7dfc576ea6db" alt=""><figcaption></figcaption></figure>

#### Top Header Bar

* Organization Switcher: Displays the active organization (e.g., *Analytiq Inc*) with "Powered by FieldWorker" branding.
* Global Search Bar: Direct search input to locate clients, projects, or contacts across the entire system.
* User Profile & Role Context: Displays the authenticated email, user name, and current role (e.g., *Sami Smithh (Admin)*).
* System Utilities & Quick Tools:
  * Application Switcher / Grid menu
  * Settings (`⚙`)
  * Quick Notes / Logs
  * Help Center / FAQ (`?`)
  * About / Info (`i`)
  * Notification Center with an unread badge counter.

The left menu can be closed to utilize more space for your main section.

<figure><img src="https://1895083124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFKFmA5xK4sMCcp1WP4Kc%2Fuploads%2FCmlVZB8JuZMesY8vyXrS%2FScreen%20Shot%202026-08-16%20at%201.19.46%20AM.png?alt=media&amp;token=40d45b4a-677f-40a2-be2c-06323a8ab03a" alt=""><figcaption></figcaption></figure>

#### Sub-Header & Quick Actions

* Dashboard Views / Module Tabs:
  * `HOME` (Active)
  * `CASELOAD REPORT`
  * `TIMESHEETS REPORT`
  * `DASHBOARD`
  * `DDD SYNC` (Division of Developmental Disabilities data synchronization)
  * `SC MANAGEMENT` (Support Coordination management)
  * `CUSTOMERS`
* Primary Action Buttons (Quick Creation):
  * `+ NEW NOTE`
  * `+ NEW TASK`
  * `+ NEW TIMESHEET`
  * `+ NEW WORKFLOW`
  * `UPLOAD`

Here is a detailed breakdown and functional explanation of the Global Search feature based on the FieldWorker interface.

### Global Search

The Global Search bar is a persistent, omnidirectional navigation tool designed to instantly retrieve records from anywhere within the platform. It acts as the ultimate shortcut, allowing administrators and care coordinators to bypass multi-step menu navigation.

#### 1. Location & UI Design

* Placement: Centrally located in the top application header. It sits between the Organization Switcher (e.g., *Analytiq Inc*) on the left and the User Profile / Utility icons on the right.
* Visibility: Because it is housed in the top header, the search bar remains pinned and accessible regardless of which module or dashboard tab the user is currently viewing.
* Visual Elements: It features a standard, elongated text input field anchored by a magnifying glass (`🔍`) icon to indicate its function clearly.

<figure><img src="https://1895083124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFKFmA5xK4sMCcp1WP4Kc%2Fuploads%2FxFpLnZZkMw5J5yrNjIUI%2FScreen%20Shot%202026-08-16%20at%201.52.50%20AM.png?alt=media&amp;token=303ef1d9-d7e6-4149-ac43-5baeb6c8f546" alt="" width="515"><figcaption></figcaption></figure>

#### 2. Functional Scope

Unlike a "local" search that only filters the data on the current screen (such as filtering a table of timesheets), a Global Search scans the entire FieldWorker database. Based on the system's architecture, it indexes and retrieves data across core operational entities, including:

* Profiles: Customers, Caregivers, Contacts, and User Accounts.
* Operations: Projects, specific Shifts, Workflows, and Tasks.
* Administration: Forms, Documents, Referrals, and potentially billing identifiers.

#### 3. Operational Behavior

* Real-Time / Type-Ahead Querying: As seen in your current session (where the letters "an" are typed into the bar), the search is designed to trigger dynamically. As the user types, the system queries the database and likely generates a dropdown list of predictive matches (e.g., pulling up a customer named *Anna*, a contact named *Andrew*, or a project containing the word *annual*).
* Direct Routing: Clicking on any of the populated search results serves as a deep link, instantly routing the user away from their current page directly into the detailed profile or record of the selected item.

#### 4. User Experience Value

The primary goal of the Global Search is frictionless efficiency. If an administrator receives a phone call regarding a specific client or shift, they do not need to click into the `Customers` module, wait for the table to load, and then run a filter. They can simply type the name directly into the top bar and jump straight to the relevant record in seconds.

### Upcoming appointments&#x20;

This section displays the upcoming appointments or tasks scheduled for you. All details about the task, including date, time, and location, are displayed. You can also scroll through all tasks if there are many upcoming tasks.

<figure><img src="https://1895083124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFKFmA5xK4sMCcp1WP4Kc%2Fuploads%2FtfzlyCndt0ElXXN4B2n8%2FSC%20Home%20Page%20Assignment.png?alt=media&amp;token=f368a3f1-3df2-4948-b56e-c160054be766" alt=""><figcaption></figcaption></figure>

A dynamic carousel widget displaying the user's next scheduled tasks (up to 5 tasks) paired with integrated geospatial tools.

* Task Header & Carousel: Shows the task name, workflow association, and scheduled timestamp.
* Interactive Map Card:
  * Embedded map view showing the task location pin.
  * Geofence / EVV Actions: Includes a direct `Check In` action linked to the destination address (e.g., *140 East Centre Street, Apt 2, Kearny, NJ*).
* Task Information Panel:
  * Assigned Staff: Name and role designation.
  * Project: Linked project name.
  * Client: Associated individual.
  * Time Remaining / Due Date: Real-time countdown and scheduled date/time.
  * Task / Service Type: Activity category (e.g., *Home Visit*).
  * Task Notes: Direct notes field for visit specifics.
* Task Actions: Direct buttons to `Reschedule` or `Cancel Appointment`.

#### Calendar Widget

Positioned alongside the Upcoming Tasks panel for fast scheduling oversight.

* View Toggles: Switch between `MONTHLY` and `DAILY` views.
* Date Navigation: Month and year navigation arrows (`«`, `‹`, `›`, `»`).
* Visual Indicators:
  * Current date highlight.
  * Color-coded day markers reflecting scheduled tasks, home visits, and deadlines.

### Approval Tasks

A dedicated review queue designed to streamline managerial and supervisory workflows.

<figure><img src="https://1895083124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFKFmA5xK4sMCcp1WP4Kc%2Fuploads%2FEQv4cAzxm7GyIUg9xyhk%2FScreen%20Shot%202026-08-16%20at%201.35.27%20AM.png?alt=media&amp;token=9c3d64d8-5607-4c27-bd0d-da81590f30b6" alt=""><figcaption></figcaption></figure>

* Status Counter: Shows real-time pending approvals (e.g., *1 pending*).
* Data Table Structure:

  <table data-header-hidden><thead><tr><th width="215.20745849609375"></th><th></th></tr></thead><tbody><tr><td><strong>Field</strong></td><td><strong>Description</strong></td></tr><tr><td>Task</td><td>Name, task identifier, and workflow context</td></tr><tr><td>Submitted By</td><td>Name of the staff member or field worker who submitted the item</td></tr><tr><td>Due</td><td>Target compliance / review due date</td></tr><tr><td>Forms</td><td>Embedded link to inspect submitted forms (e.g., <em>View 1 form</em>)</td></tr><tr><td>Actions</td><td>Quick one-click action buttons: <code>Reject</code> and <code>Approve</code></td></tr></tbody></table>

### Timesheets&#x20;

If your agency has subscribed to the Time Management feature, your timesheet entries will be accessible from this control. You can scroll through your time entries for a day, one week at a time. You may also create or edit a new timesheet entry.&#x20;

A weekly time-logging panel providing direct visibility into billable hours and missing logs.

* Date Range & Selector: Weekly date range indicator with day-by-day filter chips (`SUN` through `SAT`).
* Summary Metrics:
  * Weekly Scheduled Hours: Total scheduled time.
  * Weekly Worked Hours: Total approved/logged time.
* Empty / Status State: Displays status messaging when no entries are logged for a selected date, accompanied by a primary `+ Add Timesheet` button.

<figure><img src="https://1895083124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFKFmA5xK4sMCcp1WP4Kc%2Fuploads%2Ftl5Q3S8ykxA2DCUMoO59%2FSC%20Home%20Page%20Timesheet.png?alt=media&amp;token=cf346ffd-4ef3-4624-ae14-fb9533674dd9" alt=""><figcaption></figcaption></figure>

### Recent calls

The Fieldworker mobile app can be used to make calls to the clients and automatically record the same for audit purposes. The last 10 calls are displayed in this control.

A chronological communication feed tracking client and vendor interactions.

* Call Capacity: Displays the last 10 incoming and outgoing calls.
* Log Entry Details:
  * Contact Name and classification (e.g., *Individual*, *Corporation*).
  * Phone Number.
  * Duration of call (e.g., *30 minutes*, *1 hour*).
  * Call direction indicator (e.g., *Outgoing* `↑`).
  * ISO Timestamp of completion.

<figure><img src="https://1895083124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFKFmA5xK4sMCcp1WP4Kc%2Fuploads%2FwzZEe2iWIgHLH3rexE0l%2FSC%20Home%20Page%20Calls.png?alt=media&amp;token=4efc6189-4d93-4609-8d16-47af33af1bc7" alt=""><figcaption></figcaption></figure>

### Left Menu Bar

The sidebar acts as the primary navigational spine for administrative staff and care coordinators, spanning 17 unnested items:

* Home: The operational launchpad displaying high-level widgets (Open/Unassigned Shifts, Caregiver Utilization, Revenue at Risk, Active Shifts map, and Turnover metrics).
* Projects: Administrative groupings for agency contracts, multi-program initiatives, or grant-funded service tracks.
* Customers: The core client/individual registry containing recipient profiles, service authorizations, and individualized care plans.
* Households: Hierarchical groupings for families or shared residential settings (critical for multi-client homes or guardian coordination).
* Contacts: Directory of external parties—physicians, guardians, support coordinators, and emergency contacts.
* Employees: A staff and direct-care worker registry that manages credentials, certifications, availability, and system roles.
* Locate: Real-time GPS mapping and field tracking interface to verify field staff location and dispatch safety.
* Create (+): A modal or quick-action trigger embedded directly in the list to rapidly add records (shifts, clients, contacts, or tasks).
* Timesheets: Staff hours capture, review, and supervisor approval mechanisms before payroll and claims export.
* EVV (Electronic Visit Verification): Mandated visit verification portal logging GPS-stamped clock-ins/outs, location geo-fencing, and recipient/caregiver e-signatures.
* Billing: Revenue cycle management dashboard covering service claim generation, invoice tracking, and payer clearinghouse submissions.
* Documents: Agency and client document management system for storing medical records, state compliance files, and attachments.
* Forms: Form builder and library for state-mandated documentation, Monthly Monitoring Tools (MTs), intake assessments, and custom incident forms.
* Referrals: An intake pipeline that tracks inbound prospects from state agencies, hospitals, or families through the qualification phase.
* Scheduler: Master calendar view for booking shifts, matching staff to client availability, and handling recurring visits.
* Workflows (S): Process automation studio for routing approvals, sending automated caregiver alerts, and handling multi-step tasks.
* AI Companion (S): Conversational AI module for summarizing case history, assisting with note generation, and monitoring caseload anomalies.

<figure><img src="https://1895083124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFKFmA5xK4sMCcp1WP4Kc%2Fuploads%2FUNEQMbBUzT7NGEV4CjlN%2FFW%20Sidebar%20Open.png?alt=media&amp;token=fede666d-914d-441e-bf2c-327c24df9d4d" alt=""><figcaption></figcaption></figure>

### The App corner

The top-left corner of the landing page is common across all users. Apart from the name of the company, it also lets a user log out from their current session.

<figure><img src="https://1895083124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFKFmA5xK4sMCcp1WP4Kc%2Fuploads%2FaEonTQ34msxvZm9qFf9m%2FFW%20Top%20Left.png?alt=media&amp;token=f6dd3487-b861-4964-865b-1a3e80039c16" alt=""><figcaption></figcaption></figure>

The downward arrow icon lets users review the latest set of changes that are introduced to the app.

### The Core Functionality Corner

The top right corner of the app provides access to several common core functionalities, generally available to most agencies. Depending upon the role of the users, some of this functionality may be restricted.

The current user logged in, and the agency name is listed in the top row.

The next few icons provide access to some of the key core functionalities.

**Reports** icon opens the Fieldworker Analytics page. Core reports are available to all agencies; however, other specialized reports are displayed based on the subscription.

**Settings** icon opens up the Configuration and Customization section. Some tabs and functionality may only be available to an admin user.

**Feature Request** lets any user create a new feature request, or review and opine on existing feature requests.

**Help** icon opens up extensive user documentation with an AI-powered search to help you resolve any questions or doubts.

Information icon mentions the current version of the app and its deployment date.

**Notification** tab shows all notifications that may have been sent to the current user.

<figure><img src="https://1895083124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFKFmA5xK4sMCcp1WP4Kc%2Fuploads%2F8NmEDlwDKprrvdFluezr%2FFW%20Top%20Right.png?alt=media&amp;token=ae3d9271-bed2-433d-9254-6f6661427831" alt=""><figcaption></figcaption></figure>

Lastly, four buttons at the bottom of the top right core functionality corner provide easy access to some very common core functionality.

**NEW NOTE** lets a user quickly create a text or audio note and associate the same to a customer, project, and/or task.

**NEW TASK** lets you quickly create a task and assign it to an employee, or yourself.

**NEW TIMESHEET** allows you to quickly create a new timesheet entry for any employee under your supervision.

**UPLOAD** lets you quickly upload a document and associate it to a task, project or customer.

### Support Coordination Administration

The top bar in the main section of the landing page for Support Coordination agencies lists key functionality only available to admin users.

<figure><img src="https://1895083124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFKFmA5xK4sMCcp1WP4Kc%2Fuploads%2FVVxDw8lnkxQe2ZwNg0xl%2FSC%20Home%20Page%20Admin%20Bar.png?alt=media&amp;token=cbfac2c0-2dbb-4705-b4c1-ecf8fb748416" alt=""><figcaption></figcaption></figure>

### Home - Caseload Report&#x20;

The Caseload report tab shows all your customers and a summary of the mandated tasks that have been completed for the past year.

<figure><img src="https://1895083124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFKFmA5xK4sMCcp1WP4Kc%2Fuploads%2FMX4c0pUiNF7Z8arrJJd7%2FSC%20Home%20Page%20Caseload.png?alt=media&amp;token=b72ef4c9-7070-4f6a-aff8-7b01f53371a8" alt=""><figcaption></figcaption></figure>

### Home - Timesheets Report

The timesheet report displays all time entries submitted by all your managed employees. The tab also allows access to the customization of the reports as well.

<figure><img src="https://1895083124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFKFmA5xK4sMCcp1WP4Kc%2Fuploads%2FwI3xMbEYMqTOzuYbzP3D%2FSC%20Home%20Page%20Timesheets%20Report.png?alt=media&amp;token=8996abc7-95ce-4d52-8f23-58650fa5e305" alt=""><figcaption></figcaption></figure>

### Home - Dashboard

The dashboard tab displays a few key management indicators covering the population under management, visits completed, and any outstanding visits.

<figure><img src="https://1895083124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFKFmA5xK4sMCcp1WP4Kc%2Fuploads%2FNZozQTEiYThwbGt2QItF%2FSC%20Home%20Page%20Dashboard.png?alt=media&amp;token=fe3d7a8a-0ca3-48ec-b7ce-19c3e6a1d4ed" alt=""><figcaption></figcaption></figure>

### DDD Synch

DDD Synch tab is available to all support coordination and service provider agencies in New Jersey. This lets an admin sync data from the state system using a standard export format.

<figure><img src="https://1895083124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFKFmA5xK4sMCcp1WP4Kc%2Fuploads%2Fg2doQHSSIWB8D0r5Izib%2FSC%20Home%20Page%20DDD%20Synch.png?alt=media&amp;token=7c78b48f-1780-478e-859b-0cca64c1cd0a" alt=""><figcaption></figcaption></figure>

### Recent Notes

For a Case management company, the main section of the home page replaces the calls section with a most recent notes section. The appointment section is also minimized by default.

<figure><img src="https://1895083124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFKFmA5xK4sMCcp1WP4Kc%2Fuploads%2F1Qq1c0IwHXoM1vcEFJ1C%2FCM%20Home%20Page.png?alt=media&amp;token=13210592-c7c8-4196-883b-e6565a6fa432" alt=""><figcaption></figcaption></figure>

### Scheduler

For daycare agencies, the main section brings in the resource view of the scheduler, along with a list of customers present in the facility.

<figure><img src="https://1895083124-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFKFmA5xK4sMCcp1WP4Kc%2Fuploads%2FljGLfYFCYqtQAzlX3WZA%2FDC%20Home%20Page.png?alt=media&amp;token=30b7ce91-908c-40ec-947a-9293db24c9f5" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://fieldworker.gitbook.io/fieldworker-docs/fundamentals/pages/home-page.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
