> 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/fix.md).

# Fix

{% 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: web, iOS and Android. [Source on GitHub](https://github.com/snapfix/docs/blob/main/spec/screens/tasks/fix.md).
{% endhint %}

Where people work on tasks: one screen with tabs for the site's feed, groups, rooms and areas.

* **Where:** web `/fix` and `/fix/:tab` (`feed`, `groups`, `rooms`, `areas`), side menu "Fix"; any unknown web address also lands here. iOS and Android: bottom bar "FIX".
* **Who:** any signed-in user, in the selected site. Each tab decides what the user sees.
* **Feature:** [Task lists](https://docs.snapfix.com/product/features/tasks/task-lists.md)
* **Tabs:** [Feed](https://docs.snapfix.com/how-the-apps-work/screens/tasks/feed.md), [Groups](https://docs.snapfix.com/how-the-apps-work/screens/groups/group-list.md), Rooms ([Room tasks](https://docs.snapfix.com/how-the-apps-work/screens/rooms/room-tasks.md) and [Room status](https://docs.snapfix.com/how-the-apps-work/screens/rooms/room-status.md)) and [Areas](https://docs.snapfix.com/how-the-apps-work/screens/rooms/areas.md)

![Fix, Groups tab](https://3653879137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVVGa79QbcEkJ7n8srxe%2Fuploads%2Fgit-blob-a0856de72d89ef4311088c8d15d6e73e2a2bb242%2Ffix.png?alt=media)

## Layout

**Web**, top to bottom:

1. The app header. With a multi-site selected, the header is the multi-site one.
2. The title "Fix". With a multi-site selected, the "Groups", "Rooms" and "Areas" tabs also show a site dropdown next to the title; the feed covers every site.
3. The tabs: "Feed", "Groups", "Room Tasks" or "Room Status" (with a dropdown arrow), and "Areas". The open tab shows its count, for example "Groups (12)". All tabs are disabled while the open tab loads. While rooms are being selected in Room Status, the tab row is hidden.
4. The open tab's content.

**iOS:** the bottom bar "FIX" opens five pages: Feed, Groups, Room Tasks, Room Status and Areas. Each page shows the tab buttons "Feed", "Groups", "Room Tasks" (or "Room Status") and "Areas" at its top, and the open one shows its count, for example "Groups (12)". The pages don't swipe; only the buttons switch them.

**Android:** the bottom bar "FIX" opens the last Fix tab. Each tab shows the chips "Feed", "Groups", "Room Tasks" (with a dropdown arrow; "Room Status" when that is chosen) and "Areas" at its top. The side menu's "Housekeeping" item opens the Plan tab, not Fix ([housekeeping](https://docs.snapfix.com/how-the-apps-work/screens/housekeeping.md)).

## Inputs

| Field                  | Type                          | Required | Default                                                                                                         | Rules and messages                                                    |
| ---------------------- | ----------------------------- | -------- | --------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
| Tab                    | single choice                 | yes      | the tab last used on this site; first time "Groups"                                                             | Remembered per site, on the device.                                   |
| Rooms option           | "Room Tasks" or "Room Status" | yes      | web: "Room Tasks" each time; iOS: the last one used on this site; Android: the last one used while the app runs | Selecting the rooms tab while it's open switches to the other option. |
| Site (web, multi-site) | dropdown                      | yes      | the last site chosen                                                                                            | Shown on "Groups", "Rooms" and "Areas" only.                          |

## Actions

| Action                                          | Who                            | What happens                                                                                                                                                                                                                 | API                                                                                             |
| ----------------------------------------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| Open a tab                                      | anyone                         | Web: goes to `/fix/:tab` and stores the tab for the site. Mobile: shows the page and stores it for the site.                                                                                                                 |                                                                                                 |
| Switch site                                     | anyone with more than one site | The [site switcher](https://docs.snapfix.com/how-the-apps-work/screens/groups/site-switcher.md) changes the site; Fix opens the tab last used on the new site.                                                               |                                                                                                 |
| Open Fix (web)                                  | anyone                         | Loads the feed filter preference in the background, and, when the browser is idle, may show a marketing popup ([marketing popups](https://docs.snapfix.com/product/features/notifications/marketing-popups.md)) or a survey. | [`GET /v1/app/user/preferences`](https://docs.snapfix.com/engineering-reference/api/account.md) |
| Open from a task notification (iOS, app closed) | anyone                         | Opens "Groups", then the group and the task.                                                                                                                                                                                 |                                                                                                 |

## States

* **Loading:** web: a spinner while a tab's code loads, then the tab's own loading state; the tabs are disabled meanwhile.
* **Empty:** each tab has its own empty state.
* **Error:** each tab handles its own errors.
* **No permission:** no checks on this screen.
* **Offline (mobile):** the tabs work from the device database.

## Platform differences

| Topic                   | Web                                                                                                       | iOS                                                                   | Android            |
| ----------------------- | --------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | ------------------ |
| Tab names               | "Feed", "Groups", "Room Tasks"/"Room Status", "Areas", with "(count)"; the rooms tab has a dropdown arrow | "Feed", "Groups", "Room Tasks"/"Room Status", "Areas", with "(count)" | same as the web    |
| Remembered rooms option | no, always "Room Tasks"                                                                                   | yes, per site                                                         | while the app runs |
| Multi-site              | site dropdown for groups, rooms and areas; the feed covers all sites                                      | no multi-site                                                         | no multi-site      |


---

# 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/fix.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.
