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

# Plan

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

The mobile Plan tab: the planned tasks, the schedules, the asset registers, a Comply notice and, for account admins, housekeeping.

* **Where:** iOS and Android: the Plan icon in the bottom bar. The side menu's "Plan", "Assets", "Comply" and "Housekeeping" open the tab at that page. There is no web Plan tab: the web side menu's "Plan" opens [Planned tasks](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-tasks.md). Inside a group, "Planned Tasks" opens the [Group planner](https://docs.snapfix.com/how-the-apps-work/screens/planner/group-planner.md) instead.
* **Who:** any signed-in user; the tab itself has no role check. "Housekeeping" shows only to account admins, and only when at least one building of the site has housekeeping (AI task management) turned on.
* **Feature:** [Planned tasks](https://docs.snapfix.com/product/features/planner/planned-tasks.md), [Plan calendar](https://docs.snapfix.com/product/features/planner/plan-calendar.md)
* **Pages:** [Planned tasks](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-tasks.md), [Manage planned tasks](https://docs.snapfix.com/how-the-apps-work/screens/planner/manage-planned-tasks.md) (the "Scheduler" page), [Asset registers](https://docs.snapfix.com/how-the-apps-work/screens/assets/registers.md), the [Comply notice](https://docs.snapfix.com/how-the-apps-work/screens/compliance/mobile-notice.md), the housekeeping [Timeline](https://docs.snapfix.com/how-the-apps-work/screens/housekeeping/timeline.md)

## Layout

The bottom bar item is the Plan icon. Its label ("PLAN" on iOS; "Plan", drawn in capitals, on Android) is hidden on both, so only the icon shows.

Under the app's top bar ([Home](https://docs.snapfix.com/how-the-apps-work/screens/tasks/home.md)) each page shows the same chip row:

1. "Planned Tasks", or "Scheduler" while the schedules show. Tapping it on either of these two pages switches between [Planned tasks](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-tasks.md) and [Manage planned tasks](https://docs.snapfix.com/how-the-apps-work/screens/planner/manage-planned-tasks.md). On Android it carries a dropdown mark.
2. "Asset Registers" (Android "Asset registers"): the [asset registers](https://docs.snapfix.com/how-the-apps-work/screens/assets/registers.md). On iOS this page puts the app in asset mode, so tasks created next use the asset style until the user leaves it.
3. "Comply": the [Comply notice](#comply).
4. "Housekeeping", when allowed: the housekeeping [Timeline](https://docs.snapfix.com/how-the-apps-work/screens/housekeeping/timeline.md).

The chip of the open page is selected. iOS holds the five pages in one pager that does not swipe; only the chips switch pages. Android swaps one fragment per page into the tab.

**Side menu**, section "Task": "Fix", "Plan", "Assets", "Chat", "Comply", and "Housekeeping" when allowed. "Scheduler" is not a side menu item.

## Inputs

| Field | Type          | Required | Default         | Rules and messages                                                                                                                                                                                                                                                                             |
| ----- | ------------- | -------- | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Page  | single choice | yes      | "Planned Tasks" | iOS opens on Planned tasks, unless the side menu names another page or the app was opened from a terminated-asset notification (asset registers). Android, while the app runs, returns to the last of Planned tasks, Scheduler or Housekeeping. Asset registers and Comply are not remembered. |

## Actions

| Action                                               | Who                                        | What happens                                                                                                                                                                                                                                                                                                                                                                                 | API |
| ---------------------------------------------------- | ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- |
| Plan icon                                            | anyone                                     | Opens the tab. Android opens the last of Planned tasks, Scheduler or Housekeeping (Planned tasks if Housekeeping is no longer allowed), also when Asset registers or Comply is open.                                                                                                                                                                                                         | -   |
| "Planned Tasks" / "Scheduler" chip                   | anyone                                     | Switches between the two planner pages. From any other page it opens Planned tasks.                                                                                                                                                                                                                                                                                                          | -   |
| "Asset Registers" chip                               | anyone                                     | Opens the asset registers.                                                                                                                                                                                                                                                                                                                                                                   | -   |
| "Comply" chip                                        | anyone                                     | Opens the Comply notice.                                                                                                                                                                                                                                                                                                                                                                     | -   |
| "Housekeeping" chip                                  | account admins on a site with housekeeping | Opens the housekeeping timeline.                                                                                                                                                                                                                                                                                                                                                             | -   |
| Side menu "Plan", "Assets", "Comply", "Housekeeping" | as the chip                                | Opens the tab at that page.                                                                                                                                                                                                                                                                                                                                                                  | -   |
| "+" in the top bar                                   | anyone; hidden on Comply                   | Planned tasks and Scheduler: [Create planned task](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-task.md). Housekeeping: the create sheet of the [Timeline](https://docs.snapfix.com/how-the-apps-work/screens/housekeeping/timeline.md). Asset registers: the app's "+" menu in asset mode ([Home](https://docs.snapfix.com/how-the-apps-work/screens/tasks/home.md)). | -   |
| Switch site                                          | anyone with more than one site             | The [Site switcher](https://docs.snapfix.com/how-the-apps-work/screens/groups/site-switcher.md). If Housekeeping was open and the new site may not show it, the tab opens Planned tasks.                                                                                                                                                                                                     | -   |

## States

* **Loading, empty, error:** each page has its own; the chip row shows with the page.
* **No permission:** only the Housekeeping chip and side menu item are gated, as in **Who**.
* **Offline (mobile):** the planned tasks page reads the device copy on iOS ([Planned tasks](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-tasks.md#states)); the schedules page does not work offline.

## Comply

The Comply page is a notice, not the web Comply product ([Compliance](https://docs.snapfix.com/how-the-apps-work/screens/compliance.md)); the notice itself is described in [Mobile notice](https://docs.snapfix.com/how-the-apps-work/screens/compliance/mobile-notice.md).

* **iOS:** title "Comply", subtitle "IS LIVE ON WEB", then the message ending "…Please contact <support@snapfix.com> and we will he happy to help." and a sign-off. The word "he" is a typo for "be". The address opens a mail draft.
* **Android:** "COMPLY", "Is live on web" drawn in capitals, the same message with "we will be happy to help.", the address as a link, and the sign-off as separate lines.

## Platform differences

| Topic                                             | iOS                 | Android                                        |
| ------------------------------------------------- | ------------------- | ---------------------------------------------- |
| Asset chip                                        | "Asset Registers"   | "Asset registers"                              |
| Plan icon while Asset registers or Comply is open | -                   | opens Planned tasks, Scheduler or Housekeeping |
| Comply text                                       | "he happy"          | "be happy"                                     |
| Pages                                             | one pager, no swipe | one fragment per page                          |


---

# 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/planner/plan.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.
