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

# Areas

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

The site's areas with their task counts; opening an area shows its tasks.

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

* **Where:** web `/fix/areas`, the Fix page's "AREAS" tab (shown as "Areas (15)", with the number of areas); iOS: Fix > "Areas"; Android: the Fix tab's "Areas" chip
* **Who:** any signed-in user with a site selected. No screen checks a role. The list shows every area of the site; the counts cover only the tasks the user can see.
* **Feature:** [Rooms and areas](https://docs.snapfix.com/product/features/rooms/rooms-and-areas.md)

An area's task list is [Area](https://docs.snapfix.com/how-the-apps-work/screens/rooms/area.md). Areas are created, renamed and deleted on the web in [Areas & rooms](https://docs.snapfix.com/how-the-apps-work/screens/rooms/areas-and-rooms.md).

## Layout

**Web:** a row with a view switch (grid or list) and the "Search Areas" field; below it, the areas.

* **Grid:** each card has a round area icon, the area's name and description ("-" when there is none), and the red, amber and green counts, with "99999+" above 99999. An area with new tasks has a highlighted card.
* **List:** one full-width row per area with the same icon, name, description and counts.

The tab's label shows the area count, "Areas (15)", or "(shown / total)" while a search narrows the list, for example "Areas (1 / 15)". Skeletons show while the first page loads, and a spinner at the bottom while the next page loads. With no areas, the placeholder says "Welcome to Snapfix "Areas"" and "Here you will see all your Snapfix Tasks in an Area, and you can also quickly create new Tasks for that Area.", with a "What's New" link and <support@snapfix.com>.

**iOS:** a search button that shows the "Find areas.." field, and a table with one row per area: the name, the description, the time the area last changed, and the red, amber and green counts. With no areas, an empty view shows the same welcome text with "What's New" and the support address.

**Android:** the chips "Feed", "Groups", "Room Tasks" and "Areas (N)", a search icon that opens a field with the hint "Search areas", and a list of rows with the name, the description and the red, amber and green counts. Pull down to refresh. With no areas, an empty view shows the welcome text with the "What's New" and support links.

## Inputs

| Field                        | Type         | Required | Default                       | Rules and messages                                                                                                                                                                                                                                                              |
| ---------------------------- | ------------ | -------- | ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Search (web, "Search Areas") | Text         | No       | The last search for this site | Sent 1 second after the last key release; the list reloads from the first page. The server matches the name, title, description and instructions, ignoring case ([`POST /v1/app/areas/list`](https://docs.snapfix.com/engineering-reference/api/rooms.md#post-v1appareaslist)). |
| View (web)                   | Grid or list | No       | Grid                          | Kept per site in the browser, with the search.                                                                                                                                                                                                                                  |
| Search (iOS, Android)        | Text         | No       | Empty                         | Filters the areas on the device by name, ignoring case. No server call.                                                                                                                                                                                                         |

The web page has no filter.

## Actions

| Action                        | Who    | What happens                                                                                                                                                                  | API                                                                                                                                                                                                                                           |
| ----------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Open the list (web)           | Anyone | Loads the first page of areas with their task counts, then checks the page for new tasks. The check also records a view for every area on the page that the user hasn't seen. | [`POST /v1/app/areas/list`](https://docs.snapfix.com/engineering-reference/api/rooms.md#post-v1appareaslist), then [`POST /v1/app/areas/get-updates`](https://docs.snapfix.com/engineering-reference/api/rooms.md#post-v1appareasget-updates) |
| Search (web)                  | Anyone | Reloads the list with the search text.                                                                                                                                        | [`POST /v1/app/areas/list`](https://docs.snapfix.com/engineering-reference/api/rooms.md#post-v1appareaslist)                                                                                                                                  |
| Load more (web)               | Anyone | Scrolling to the end loads the next page, until the last page.                                                                                                                | [`POST /v1/app/areas/list`](https://docs.snapfix.com/engineering-reference/api/rooms.md#post-v1appareaslist)                                                                                                                                  |
| Change the view (web)         | Anyone | Switches between grid and list.                                                                                                                                               | None                                                                                                                                                                                                                                          |
| Check for new tasks (Android) | Anyone | Areas with new tasks get a highlighted row.                                                                                                                                   | [`?action=read_area_jobs_new_updates`](https://docs.snapfix.com/engineering-reference/api/tasks.md#post-actionread_area_jobs_new_updates)                                                                                                     |
| Open an area                  | Anyone | Opens [Area](https://docs.snapfix.com/how-the-apps-work/screens/rooms/area.md) (web `/area/:id/tasks`).                                                                       | The area page's own calls ([Area](https://docs.snapfix.com/how-the-apps-work/screens/rooms/area.md#actions))                                                                                                                                  |
| Refresh (apps)                | Anyone | Pulling down runs the data sync, then reloads the list from the device.                                                                                                       | The data sync ([shared behavior](https://docs.snapfix.com/how-the-apps-work/shared.md))                                                                                                                                                       |

## States

* **Loading:** web: skeletons in the grid or list until the first page arrives. iOS and Android show the areas on the device at once.
* **Empty:** the welcome text of each platform ([Layout](#layout)). On the web, a search with no match shows it too.
* **Error:** web: the list request shows no error. When the first page fails, the tab reads "Areas (Undefined)" and the welcome text shows, as if the site had no areas. The apps read the device copy.
* **No permission:** none. Every signed-in member of the site sees every area.
* **Offline (mobile):** the device copy of the areas and the counts last stored.

## Platform differences

| Topic                     | Web                                                                                                                            | iOS                                          | Android                |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------- | ---------------------- |
| Layout                    | Grid or list                                                                                                                   | Table                                        | List                   |
| Where the list comes from | [`POST /v1/app/areas/list`](https://docs.snapfix.com/engineering-reference/api/rooms.md#post-v1appareaslist), 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 |
| New-task mark             | Yes                                                                                                                            | Never: the check is switched off in the code | Yes                    |
| Count cap                 | "99999+" (rooms: "99+")                                                                                                        | None                                         | None                   |
| Pull to refresh           | No                                                                                                                             | Yes                                          | Yes                    |


---

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