> 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/rooms/room-tasks.md).

# Room tasks

{% 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/rooms/room-tasks.md).
{% endhint %}

The site's rooms as cards, each with its task counts by colour; opening a room shows its tasks.

![Room tasks](https://3653879137-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsVVGa79QbcEkJ7n8srxe%2Fuploads%2Fgit-blob-f95fe75d90ca81bb777ffa42192f6db20d7306f4%2Froom-tasks.png?alt=media)

* **Where:** web `/fix/rooms`, the Fix page's "Rooms" tab on its "ROOM TASKS" option (shown as "Room Tasks (122)", with the number of rooms); iOS: Fix > "Room Tasks"; Android: the Fix tab's "Room Tasks" chip
* **Who:** any signed-in user with a site selected. No screen checks a role. The list shows every room of the site; the counts cover only the tasks the user can see ([room object](https://docs.snapfix.com/engineering-reference/api/rooms.md#room-object)).
* **Feature:** [Rooms and areas](https://docs.snapfix.com/product/features/rooms/rooms-and-areas.md)

The same tab, button or chip switches to [Room status](https://docs.snapfix.com/how-the-apps-work/screens/rooms/room-status.md). A room's task list is [Room](https://docs.snapfix.com/how-the-apps-work/screens/rooms/room.md).

## Layout

**Web**, top to bottom:

1. The "Search Rooms" field at the top right.
2. A grid of room cards. Each card shows the room name, cut at 10 characters (larger when the name is short); the time the room last changed, as "MMM DD, HH:mm"; and the red, amber and green task counts, with "99+" above 99. A room with new tasks has its name highlighted, and a thin progress bar runs on each card while the check for new tasks runs.
3. With no rooms, the placeholder: "Welcome to Snapfix "Rooms"", "Here you will see all your Snapfix Tasks in a Room, and you can also quickly create new Tasks for that Room.", a line with a "What's New" link and <support@snapfix.com>, and "Happy Snapfixing!".

The tab's label shows the room count: "Room Tasks (122)", or "(shown / total)" while a search narrows the list. A page holds as many cards as fit the window, and at least 20; scrolling to the end loads the next page.

**iOS:** a search button that shows the "Find Room.." field over the rooms already loaded. Three cards per row, each with the room name, the time it last changed and the red, amber and green counts; a room with new tasks has its name highlighted. Pull down to refresh. The Fix bar's "Room Tasks" button shows the count. With no rooms, an empty view says "Welcome to Snapfix "Rooms"" and "Here you will see all your Snapfix Tasks in a Room, and you can also quickly create new Tasks for that Room.", with "What's New" and the support address.

**Android:** the chips "Feed", "Groups", "Room Tasks (N)" and "Areas", a search icon that opens a field with the hint "Search rooms", and a grid of cards with the room name, the time it last changed and the red, amber and green counts (full numbers). Pull down to refresh. With no rooms, an empty view shows "Welcome to Snapfix "Rooms"" and the same description, with links to "What's New" and <support@snapfix.com>.

## Inputs

| Field                        | Type | Required | Default                       | Rules and messages                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ---------------------------- | ---- | -------- | ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Search (web, "Search Rooms") | Text | No       | The last search for this site | Sent 1 second after the last key release; Enter is just another key release. The list reloads from the first page. The server matches the room's name, title, description, instructions and main status name, ignoring case ([`POST /v1/app/rooms/list`](https://docs.snapfix.com/engineering-reference/api/rooms.md#post-v1approomslist)). No length limit and no message: a 556-character search returned no rooms. The search is kept per site in the browser. |
| Search (iOS, Android)        | Text | No       | Empty                         | Filters the rooms already on the device by name, ignoring case, on each change. No server call.                                                                                                                                                                                                                                                                                                                                                                   |

## Actions

| Action                | Who    | What happens                                                                                                                                                                                                                                                                                                                                         | API                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| --------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Open the list (web)   | Anyone | Loads the first page of rooms with their task counts, then checks the page for new tasks. Counts change when the check returns.                                                                                                                                                                                                                      | [`POST /v1/app/rooms/list`](https://docs.snapfix.com/engineering-reference/api/rooms.md#post-v1approomslist), then [`POST /v1/app/rooms/get-updates`](https://docs.snapfix.com/engineering-reference/api/rooms.md#post-v1approomsget-updates)                                                                                                                                                                                          |
| Search (web)          | Anyone | Reloads the list with the search text.                                                                                                                                                                                                                                                                                                               | [`POST /v1/app/rooms/list`](https://docs.snapfix.com/engineering-reference/api/rooms.md#post-v1approomslist)                                                                                                                                                                                                                                                                                                                           |
| Load more (web)       | Anyone | Scrolling to the end loads the next page, until the last page.                                                                                                                                                                                                                                                                                       | [`POST /v1/app/rooms/list`](https://docs.snapfix.com/engineering-reference/api/rooms.md#post-v1approomslist)                                                                                                                                                                                                                                                                                                                           |
| Check for new tasks   | Anyone | Rooms with new tasks get a highlighted name. The web call also records a view for every room on the page that the user hasn't seen. iOS first sends its pending room views. Android clears the mark when the room is opened; iOS clears it when the user comes back from the room.                                                                   | Web: [`POST /v1/app/rooms/get-updates`](https://docs.snapfix.com/engineering-reference/api/rooms.md#post-v1approomsget-updates). Apps: [`?action=read_room_jobs_new_updates`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionread_room_jobs_new_updates); iOS also [`?action=save_pri_log_roomvieweduser`](https://docs.snapfix.com/engineering-reference/api/rooms.md#post-actionsave_pri_log_roomvieweduser) |
| Open a room           | Anyone | Opens [Room](https://docs.snapfix.com/how-the-apps-work/screens/rooms/room.md) (web `/room/:id/tasks`). The web logs the room opened to analytics.                                                                                                                                                                                                   | The room page's own calls ([Room](https://docs.snapfix.com/how-the-apps-work/screens/rooms/room.md#actions))                                                                                                                                                                                                                                                                                                                           |
| Switch to room status | Anyone | Web: clicking the active "Rooms" tab again switches between "Room Tasks" and "Room Status"; its chevron marks the options and opens no menu. iOS: tapping "Room Tasks" again. Android: tapping the "Room Tasks" chip again, which turns the same screen into [Room status](https://docs.snapfix.com/how-the-apps-work/screens/rooms/room-status.md). | None                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Refresh (apps)        | Anyone | Pulling down runs the data sync, then reloads the rooms and their counts from the device.                                                                                                                                                                                                                                                            | The data sync ([shared behavior](https://docs.snapfix.com/how-the-apps-work/shared.md))                                                                                                                                                                                                                                                                                                                                                |

## States

* **Loading:** web: skeleton cards until the first page arrives, and a spinner at the bottom while the next page loads. iOS shows the rooms on the device at once. Android shows the refresh spinner during the first load; while the rooms of a new sign-in are still downloading, it shows the spinner instead of the empty view.
* **Empty:** the placeholder of each platform ([Layout](#layout)). On the web, a search with no match shows the same placeholder.
* **Error:** web: the list request shows no error. When the first page fails, the tab reads "Room Tasks (Undefined)" and the placeholder shows, as if the site had no rooms. A failed later page keeps the cards already loaded, and the tab reads "(Undefined)" too. The apps read the device copy, so they show no request error.
* **No permission:** none. Every signed-in member of the site sees every room.
* **Offline (mobile):** the device copy of the rooms and the counts last stored. The check for new tasks needs a connection.

## Platform differences

| Topic                     | Web                                                                                                                            | iOS                          | Android                    |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | ---------------------------- | -------------------------- |
| Where the list comes from | [`POST /v1/app/rooms/list`](https://docs.snapfix.com/engineering-reference/api/rooms.md#post-v1approomslist), a page at a time | The device copy              | The device copy            |
| Search                    | On the server, several fields                                                                                                  | On the device, by name       | On the device, by name     |
| Count cap on a card       | "99+"                                                                                                                          | None                         | None                       |
| Pull to refresh           | No                                                                                                                             | Yes                          | Yes                        |
| New-task mark cleared     | When the room is left with updates seen ([Room](https://docs.snapfix.com/how-the-apps-work/screens/rooms/room.md#actions))     | On coming back from the room | When the room is opened    |
| Room status               | Another option of the same tab                                                                                                 | Another view, same button    | The same screen, same chip |


---

# 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/rooms/room-tasks.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.
