> For the complete documentation index, see [llms.txt](https://docs.snapfix.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.snapfix.com/how-the-apps-work/screens/tasks/home.md).

# Home

{% hint style="info" %}
Draft, written by an agent and not yet checked by a person ([how to read these docs](https://docs.snapfix.com/how-to-read.md)). Platforms: iOS and Android. [Source on GitHub](https://github.com/snapfix/docs/blob/main/spec/screens/tasks/home.md).
{% endhint %}

The mobile app's frame: the bottom bar switches between Snap, Fix, Chat and Plan; the top bar holds the profile photo, the site, Snapfix AI and the "+" menu; the profile photo opens the side menu.

* **Where:** iOS and Android: opens after the [splash screen](https://docs.snapfix.com/how-the-apps-work/screens/account/splash.md) for a signed-in user with a site, and stays around every main page.
* **Who:** any signed-in user with a site. What changes per role: the "+" menu items, "Users" and "Housekeeping" in the side menu (site admins), Snapfix AI (sites that have it on) and Chat (sites that have chat on); see each section.
* **Feature:** [Creating tasks](https://docs.snapfix.com/product/features/tasks/task-creation.md)

## Layout

1. **Top bar**, on every main page: the user's profile photo (or initials) on the left; the current site's logo (or its initials) with a down arrow; then the Snapfix AI button and "+" on the right. The bar shows the site's logo, not its name.
2. **Page content:** the page of the selected tab.
3. **Bottom bar:** four icons without labels, Snap, Fix, Chat and Plan, with the selected one highlighted. Chat shows the unread count.

At launch the app opens Fix, on the page last used for the current site, or "GROUPS" the first time ([Fix](https://docs.snapfix.com/how-the-apps-work/screens/tasks/fix.md)). Launches from a notification or a link open their target on top ([shared behavior](https://docs.snapfix.com/how-the-apps-work/shared.md)). iOS also opens the camera from its home-screen quick action, without the location step.

### Bottom bar

| Tab  | Opens                                                                                                                                                                                        | Notes                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ---- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Snap | The [Camera](https://docs.snapfix.com/how-the-apps-work/screens/tasks/camera.md), to start a new task                                                                                        | Never stays selected. iOS reads the location first, showing "Getting Location..."; when GPS fails it says "Looks like GPS is not available. We will use the last known GPS location for this new task. You may wish to manually alter this location later." On the first tap after installing, iOS only asks for location access and doesn't open the camera; a second tap does. Android asks for location access ("To create a task allow Snapfix access to your device's location."), goes on without it, then asks for camera, storage and microphone access |
| Fix  | [Fix](https://docs.snapfix.com/how-the-apps-work/screens/tasks/fix.md), on its last page                                                                                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Chat | [Chats](https://docs.snapfix.com/how-the-apps-work/screens/chat/chats.md), or [My network](https://docs.snapfix.com/how-the-apps-work/screens/chat/my-network.md) when the site has chat off | The badge counts the chats with unread messages, leaving out archived chats; it hides when chat is off. Android caps it at "999+"                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Plan | [Plan](https://docs.snapfix.com/how-the-apps-work/screens/planner/plan.md), on its last page                                                                                                 |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |

Changing tab on iOS returns the tab you left to its first screen. Android keeps two more tabs, Track and Comply, hidden in the layout \[[ASK-10](https://github.com/snapfix/docs/blob/main/ASK.md#ask-10-which-differences-between-the-ios-and-android-apps-are-intended)].

### Top bar

| Control                  | Shown                                                                   | Does                                                                                                                                                                                                                                                                    |
| ------------------------ | ----------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Profile photo            | Always                                                                  | Opens the side menu (below)                                                                                                                                                                                                                                             |
| Site logo and down arrow | Always                                                                  | Opens the [site switcher](https://docs.snapfix.com/how-the-apps-work/screens/groups/site-switcher.md)                                                                                                                                                                   |
| Snapfix AI               | When the site has the AI agent on (site setting)                        | Opens [Snapfix AI](https://docs.snapfix.com/how-the-apps-work/screens/ai/assistant.md). The first time, a tip points at the button. iOS checks the setting again on tap. Android hides the button on the Comply page; iOS hides it on the Chat page, which adds its own |
| "+"                      | Every page except Comply; iOS also hides it on Chat, which adds its own | Depends on the page (below)                                                                                                                                                                                                                                             |

### The "+" menu

On the Fix pages (Feed, Groups, Room Tasks, Areas), and on My Network when chat is off, "+" opens a menu:

| Item                                                             | Shown to                                                                                                        | Opens                                                                                                                                 |
| ---------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| "Create a new task"                                              | Members of at least one task group of the site                                                                  | The [Camera](https://docs.snapfix.com/how-the-apps-work/screens/tasks/camera.md), after the same location step as Snap                |
| "Create a new Voice Task" ("Create a New Voice Task" on Android) | Same                                                                                                            | [Voice task](https://docs.snapfix.com/how-the-apps-work/screens/tasks/voice-task.md)                                                  |
| "Create a new Group" ("Create a new group" on Android)           | Users the site lets create groups                                                                               | [Create a new group](https://docs.snapfix.com/how-the-apps-work/screens/groups/create-group.md)                                       |
| "Add a New User"                                                 | iOS: site admins and admins of any task group of the site. Android: site admins and users who may create groups | The "Add a new user" sheet: by phone, email or QR code ([Users](https://docs.snapfix.com/how-the-apps-work/screens/console/users.md)) |

On the Plan tab's asset registers, "+" opens the asset version of the menu:

| Item                                                   | Shown to                                                                                     | Opens                                                                                                         |
| ------------------------------------------------------ | -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| "Scan Asset QR or Barcode"                             | Everyone                                                                                     | The [Code scanner](https://docs.snapfix.com/how-the-apps-work/screens/assets/code-scanner.md)                 |
| "Scan Asset Smart Tag"                                 | Everyone                                                                                     | The Smart Tag (NFC) scan sheet, which looks the tag up among the site's assets                                |
| "Create a new asset" ("Create a new Asset" on Android) | Android: members of at least one asset register. iOS: only users the site lets create groups | The [Camera](https://docs.snapfix.com/how-the-apps-work/screens/tasks/camera.md), to photograph the new asset |
| "Create a new asset register"                          | Users the site lets create groups                                                            | [Create a new asset register](https://docs.snapfix.com/how-the-apps-work/screens/assets/create-register.md)   |
| "Add a New User"                                       | Android only: site admins                                                                    | As above                                                                                                      |

On other pages "+" acts at once:

| Page                              | "+" opens                                                                                                                                                                                                  |
| --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Plan, planned tasks and schedules | [Create planned task](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-task.md)                                                                                                          |
| Plan, housekeeping                | The new housekeeping task sheet ([Task timeline](https://docs.snapfix.com/how-the-apps-work/screens/housekeeping/timeline.md))                                                                             |
| Fix, room status                  | An information sheet: "Snapfix Rooms", "Snapfix Rooms provides real-time visibility on the status of each room, to your entire team. Please contact your Account Admin for further information.", and "Ok" |
| Chat, with chat on                | A new chat ([Chats](https://docs.snapfix.com/how-the-apps-work/screens/chat/chats.md)); on iOS this is the Chat page's own "+"                                                                             |

### Side menu

Slides in from the left when the profile photo is tapped. From top to bottom:

1. **Profile card:** photo, name, and the user's email or username (iOS falls back to the phone number, then the staff username). Opens the profile hub on "My Profile" ([My profile](https://docs.snapfix.com/how-the-apps-work/screens/account/profile.md)).
2. **"Task":** "Fix", "Plan", "Assets", "Chat" (with the unread count), "Comply", and "Housekeeping" for site admins when the site has housekeeping on. "Fix" and "Chat" select those tabs; "Plan", "Assets", "Comply" and "Housekeeping" open the Plan tab on the planned tasks, asset registers, Comply ([Comply](https://docs.snapfix.com/how-the-apps-work/screens/compliance/mobile-notice.md)) or housekeeping page.
3. **"Site":** "Site Administration", which expands to "Site Details" and, for site admins, "Users". Android shows non-admins "Site Details" on its own instead. They open the Site Console on [Site details](https://docs.snapfix.com/how-the-apps-work/screens/console/site-details.md) or [Users](https://docs.snapfix.com/how-the-apps-work/screens/console/users.md).
4. **"Support":** "HelpHub" (shown as "Help" and "Hub"): the profile hub's [Help Hub](https://docs.snapfix.com/how-the-apps-work/screens/help/help-hub.md) tab.
5. **"Settings":** "Settings" opens the profile hub's [Settings](https://docs.snapfix.com/how-the-apps-work/screens/account/app-settings.md) tab; "Reload" asks to reload (below).
6. "Logout from Snapfix" (iOS) or "Log Out of Snapfix" (Android).
7. **Version footer:** the app version, such as "v6.10.82", and "© 2026 Terms and conditions apply. Snapfix Ltd. All rights reserved."; staging builds add "(Staging)" (iOS) or ".staging" (Android).

## Inputs

None.

## Actions

| Action                     | Who                         | What happens                                                                                                                                                                                                                                                                                                        | API                                                                                                     |
| -------------------------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------- |
| Tap a tab                  | Anyone                      | Shows that tab; Snap starts the camera flow instead                                                                                                                                                                                                                                                                 | -                                                                                                       |
| Tap a side menu item       | Anyone who sees it          | Closes the menu and opens the item's page                                                                                                                                                                                                                                                                           | -                                                                                                       |
| "Reload"                   | Anyone                      | Asks "Are you sure you want to reload all Snapfix tasks?" ("Reload" on Android) with "Yes" and "No". "Yes" clears the device's data and opens [Reloading Snapfix](https://docs.snapfix.com/how-the-apps-work/screens/account/download-data.md). iOS needs a connection first; Android asks for storage access first | -                                                                                                       |
| Log out                    | Anyone                      | Asks "Are you sure you want to Logout?" (iOS) or "Confirm Logout", "Are you sure you want to logout?" (Android); "Logout" signs out and opens [Sign in](https://docs.snapfix.com/how-the-apps-work/screens/account/sign-in.md)                                                                                      | Sign-out through the auth API ([shared behavior](https://docs.snapfix.com/how-the-apps-work/shared.md)) |
| Tap the version five times | Anyone                      | Shows "Snapfix" and the version, such as "Snapfix v6.10.82", and uploads the app's local database, zipped, to Snapfix for support, without asking. Android asks for storage access first and also shows "Sync all Data"                                                                                             | [`ANY ?action=save_sqlite`](https://docs.snapfix.com/engineering-reference/api/files.md)                |
| "Sync all Data" (Android)  | Anyone, after the five taps | Asks "If you have a lot of data it may take several minutes to sync. Please ensure you have good WiFi before proceeding."; "Ok" marks all the device's data as not synced and starts a sync                                                                                                                         | Offline sync ([shared behavior](https://docs.snapfix.com/how-the-apps-work/shared.md))                  |

## States

* **Loading:** the frame itself doesn't load anything; each page shows its own loading state.
* **Empty:** each page has its own empty state. A user without task groups sees no "Create a new task" in "+".
* **Error:** each page handles its own errors.
* **No permission:** items the user may not use are hidden, as listed above.
* **Offline (mobile):** the frame and its pages work from the device's data. Snap and "+" still create tasks, which sync later. "Reload" on iOS shows "You must be connected to the Internet to carry out this task. Please connect and try again."

## Platform differences

* **Chat badge:** Android shows at most "999+"; iOS shows the full count.
* **Site Administration (side menu):** iOS shows it to everyone, with "Users" only for site admins; Android shows it only to site admins and gives others "Site Details" alone.
* **"Add a New User" in "+":** different rules per platform, and Android also offers it on asset registers.
* **Version taps:** iOS uploads the database without asking; Android asks for storage access first. Only Android then offers "Sync all Data": iOS sets up the same button in its older menu, which the current side menu covers.
* **Snap:** the first tap on iOS can stop at the location prompt; Android asks for every permission in turn and goes on.


---

# 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://docs.snapfix.com/how-the-apps-work/screens/tasks/home.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.
