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

# Navigation

{% 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)). [Source on GitHub](https://github.com/snapfix/docs/blob/main/spec/nav.md).
{% endhint %}

Where each screen of the Snapfix apps sits and how people move between them: the web routes of the customer app, the other web apps, the staff admin app, and the screens of the iOS and Android apps. What each screen shows and does is in its [screen doc](https://docs.snapfix.com/how-the-apps-work/screens.md); this page only places it. Behavior shared by many screens (session expiry, site switching, permission checks) is in [Shared behavior](https://docs.snapfix.com/how-the-apps-work/shared.md).

Code pins: web\_app\_v2 @ 0989b8e685, qr\_forms @ bdfc4f20a5, web\_onboarding\_form @ 099b91d4e3, web\_tasks @ 3d85aa7a15, web\_payments @ 7c2c3ddffd, dynamic-link @ 4d1cd0eb62, ops\_dashboard\_fe @ bbb2959b3b, webadmin\_angular @ db972390b8, ios @ aa31967ac8, android @ 86068bfeea.

## How to read the maps

* A web node shows its route; `:id` is a route parameter. A mobile node shows the screen. Dialogs, sheets and side panels appear only where they are the way to another screen.
* An arrow is a way from one screen to the next. A label on an arrow is the button or the condition.
* A dashed arrow is something that happens to the user, not a tap (a failed session renewal, for example), or a path in the code that nothing reaches.
* Each node links to its screen doc (click it in a viewer that supports Mermaid links). The list under each map holds the same links.
* Wildcard routes (addresses that match nothing else) are not drawn. Where they lead is written under each map.
* Mobile maps cover iOS and Android together. "(iOS)" or "(Android)" marks a screen or a step that only one app has.
* Screens and dialogs that nothing opens are listed in [Not reachable or not drawn](#not-reachable-or-not-drawn), not in the maps.

## Web: sign-in and public pages

Pages of web\_app\_v2 (web.snapfix.com) that work without signing in. `/auth/*` runs `authSigninGuard`, which sends a signed-in user to `/fix` (web\_app\_v2 @ 0989b8e685, `src/app/app.routes.ts:25-26`, `src/app/services/auth/auth-guard/auth-signin/auth-signin.guard.ts:13-16`).

```mermaid
flowchart LR
  wAccess["/account-access?ctx=..."]
  wSignIn["/auth/sign-in"]
  wForgot["/auth/forgot-password"]
  wForgotCode["Code step of forgot password"]
  wReset["/auth/set-password, reset link"]
  wInvite["/auth/set-password, invitation"]
  wHelp["/auth/help-hub-faq"]
  wTouch["/auth/get-in-touch"]
  wFix["/fix"]
  wMini["Mini sign-in dialog"]
  wCode["Code step of the mini sign-in"]
  wDeleted["/delete-user-confirmation"]
  wProfile["My Profile drawer"]
  wAccess -->|"reset link"| wReset
  wAccess -->|"invitation"| wInvite
  wSignIn --> wForgot
  wForgot -->|"SEND ONE-TIME CODE"| wForgotCode
  wSignIn --> wHelp
  wForgot --> wHelp
  wReset --> wHelp
  wInvite --> wHelp
  wHelp -->|"Get In Touch"| wTouch
  wSignIn -->|"signed in"| wFix
  wFix -.->|"session cannot renew"| wMini
  wMini --> wCode
  wProfile -->|"Delete My Profile"| wDeleted
  click wAccess "screens/account/account-access.md"
  click wSignIn "screens/account/sign-in.md"
  click wForgot "screens/account/forgot-password.md"
  click wForgotCode "screens/account/forgot-password-code.md"
  click wReset "screens/account/reset-password.md"
  click wInvite "screens/account/accept-invitation.md"
  click wHelp "screens/help/login-help.md"
  click wTouch "screens/help/get-in-touch.md"
  click wFix "screens/tasks/fix.md"
  click wMini "screens/account/sign-in.md"
  click wCode "screens/account/login-code.md"
  click wDeleted "screens/account/profile-deleted.md"
  click wProfile "screens/account/profile.md"
```

Screens: [Account access](https://docs.snapfix.com/how-the-apps-work/screens/account/account-access.md), [Sign in](https://docs.snapfix.com/how-the-apps-work/screens/account/sign-in.md) (the mini sign-in dialog is under its [Dialogs and sheets](https://docs.snapfix.com/how-the-apps-work/screens/account/sign-in.md#dialogs-and-sheets)), [Forgot password](https://docs.snapfix.com/how-the-apps-work/screens/account/forgot-password.md), [Forgot password code](https://docs.snapfix.com/how-the-apps-work/screens/account/forgot-password-code.md), [Reset password from link](https://docs.snapfix.com/how-the-apps-work/screens/account/reset-password.md), [Accept invitation](https://docs.snapfix.com/how-the-apps-work/screens/account/accept-invitation.md), [Help with logging in](https://docs.snapfix.com/how-the-apps-work/screens/help/login-help.md), [Get in touch](https://docs.snapfix.com/how-the-apps-work/screens/help/get-in-touch.md), [Fix](https://docs.snapfix.com/how-the-apps-work/screens/tasks/fix.md), [Login code](https://docs.snapfix.com/how-the-apps-work/screens/account/login-code.md), [Snapfix profile deleted](https://docs.snapfix.com/how-the-apps-work/screens/account/profile-deleted.md), [My profile](https://docs.snapfix.com/how-the-apps-work/screens/account/profile.md).

Links in emails and SMS reach `/account-access` through the [Deep link](https://docs.snapfix.com/how-the-apps-work/screens/account/deep-link.md) page ([other web apps](#web-other-apps)). Unknown `/auth/...` addresses go to `/auth/sign-in` (`src/app/pages/auth/auth.routes.ts:15`). There is no sign-up route ([Not reachable](#not-reachable-or-not-drawn)).

## Web: the signed-in app

Every page below sits under the `''` route, which runs `authMainGuard`; a signed-out user goes to `/auth/sign-in` (`src/app/app.routes.ts:43-46`). The side menu opens the first page of each area, and `/fix` is the landing page. The side menu items and who sees them are in the [web inventory](https://github.com/snapfix/docs/blob/main/notes/inventory/web.md#menu).

### Fix, groups, rooms, areas and tasks

`/fix` opens the tab last used on the site, or `groups` the first time (`src/app/pages/fix/fix.component.ts:48`).

```mermaid
flowchart LR
  wFix["/fix"]
  wFeed["/fix/feed"]
  wGroups["/fix/groups"]
  wRoomTasks["/fix/rooms, Room Tasks"]
  wRoomStatus["/fix/rooms, Room Status"]
  wAreas["/fix/areas"]
  wAddTask["Add task dialog"]
  wApproval["Approval activity dialog"]
  wCreateGroup["Create group dialog"]
  wPurpose["Group details dialog"]
  wGroupTasks["/group/:id/tasks"]
  wGroupPlanner["/group/:id/planner"]
  wGroupSettings["/group/:id/settings"]
  wQR["Group QR codes dialog"]
  wGroupTask["/group/:id/task/:taskId"]
  wRoom["/room/:id/tasks"]
  wRoomTask["/room/:id/task/:taskId"]
  wArea["/area/:id/tasks"]
  wAreaTask["/area/:id/task/:taskId"]
  wGallery["Photo gallery"]
  wChecklist["Checklist"]
  wEditChecklist["Checklist editor"]
  wCopyMove["Copy or move dialog"]
  wPlanCreate["/plan/planned-task/create/task/:id"]
  wFix --> wFeed
  wFix --> wGroups
  wFix --> wRoomTasks
  wFix --> wRoomStatus
  wFix --> wAreas
  wFeed -->|"+"| wAddTask
  wFeed -->|"Audit Trail"| wApproval
  wFeed --> wGroupTask
  wGroups -->|"+"| wCreateGroup
  wGroups --> wPurpose
  wGroups --> wGroupTasks
  wGroupTasks -->|"+"| wAddTask
  wGroupTasks -->|"Audit Trail"| wApproval
  wGroupTasks -->|"Planned Tasks tab"| wGroupPlanner
  wGroupTasks --> wGroupSettings
  wGroupTasks --> wQR
  wGroupTasks --> wPurpose
  wGroupTasks --> wGroupTask
  wGroupSettings -->|"Group QR"| wQR
  wRoomTasks --> wRoom
  wRoomStatus -->|"Room tasks card"| wRoom
  wRoom --> wRoomTask
  wAreas --> wArea
  wArea --> wAreaTask
  wGroupTask --> wGallery
  wGroupTask --> wChecklist
  wChecklist -->|"Edit"| wEditChecklist
  wGroupTask -->|"Actions"| wCopyMove
  wGroupTask -->|"Create Planned Task"| wPlanCreate
  click wFix "screens/tasks/fix.md"
  click wFeed "screens/tasks/feed.md"
  click wGroups "screens/groups/group-list.md"
  click wRoomTasks "screens/rooms/room-tasks.md"
  click wRoomStatus "screens/rooms/room-status.md"
  click wAreas "screens/rooms/areas.md"
  click wAddTask "screens/tasks/add-task.md"
  click wApproval "screens/tasks/approval-activity.md"
  click wCreateGroup "screens/groups/create-group.md"
  click wPurpose "screens/groups/group-purpose.md"
  click wGroupTasks "screens/tasks/group-tasks.md"
  click wGroupPlanner "screens/planner/group-planner.md"
  click wGroupSettings "screens/groups/group-settings.md"
  click wQR "screens/groups/qr-codes.md"
  click wGroupTask "screens/tasks/task-detail.md"
  click wRoom "screens/rooms/room.md"
  click wRoomTask "screens/tasks/task-detail.md"
  click wArea "screens/rooms/area.md"
  click wAreaTask "screens/tasks/task-detail.md"
  click wGallery "screens/tasks/gallery.md"
  click wChecklist "screens/checklists/checklist.md"
  click wEditChecklist "screens/checklists/edit-checklist.md"
  click wCopyMove "screens/tasks/copy-move.md"
  click wPlanCreate "screens/planner/planned-task.md"
```

Screens: [Fix](https://docs.snapfix.com/how-the-apps-work/screens/tasks/fix.md), [Feed](https://docs.snapfix.com/how-the-apps-work/screens/tasks/feed.md), [Group list](https://docs.snapfix.com/how-the-apps-work/screens/groups/group-list.md), [Room tasks](https://docs.snapfix.com/how-the-apps-work/screens/rooms/room-tasks.md), [Room status](https://docs.snapfix.com/how-the-apps-work/screens/rooms/room-status.md), [Areas](https://docs.snapfix.com/how-the-apps-work/screens/rooms/areas.md), [Add task](https://docs.snapfix.com/how-the-apps-work/screens/tasks/add-task.md), [Approval activity](https://docs.snapfix.com/how-the-apps-work/screens/tasks/approval-activity.md), [Create group](https://docs.snapfix.com/how-the-apps-work/screens/groups/create-group.md), [Group purpose](https://docs.snapfix.com/how-the-apps-work/screens/groups/group-purpose.md), [Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md), [Group planner](https://docs.snapfix.com/how-the-apps-work/screens/planner/group-planner.md), [Group settings](https://docs.snapfix.com/how-the-apps-work/screens/groups/group-settings.md), [Group QR codes](https://docs.snapfix.com/how-the-apps-work/screens/groups/qr-codes.md), [Task detail](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md), [Room](https://docs.snapfix.com/how-the-apps-work/screens/rooms/room.md), [Area](https://docs.snapfix.com/how-the-apps-work/screens/rooms/area.md), [Gallery](https://docs.snapfix.com/how-the-apps-work/screens/tasks/gallery.md), [Checklist](https://docs.snapfix.com/how-the-apps-work/screens/checklists/checklist.md), [Edit checklist](https://docs.snapfix.com/how-the-apps-work/screens/checklists/edit-checklist.md), [Copy or move](https://docs.snapfix.com/how-the-apps-work/screens/tasks/copy-move.md), [Create planned task](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-task.md).

The arrows from task detail hold for the room and area task routes too. The "Planned Tasks" tab switches the group's page in place; the address `/group/:id/planner` can open the "Tasks" tab instead. Unknown addresses go to `/fix` (`src/app/app.routes.ts:202`).

### Plan, assets, dashboards and reports

```mermaid
flowchart LR
  wPlanner["/plan/planner"]
  wManage["Manage Planned Tasks column"]
  wGroupPlanner["Group planner tab"]
  wCreate["/plan/planned-task/create"]
  wCreateGroup["/plan/planned-task/create/group/:id"]
  wCreateTask["/plan/planned-task/create/task/:id"]
  wEditOne["/plan/planned-task/edit/:id/:date"]
  wEditAll["/plan/planned-task/edit/:id/settings"]
  wAssets["/assets"]
  wAssetList["/asset-register/:id/assets"]
  wAsset["/asset-register/:id/asset/:assetId"]
  wRegSettings["/asset-register/:id/settings"]
  wDash["/dashboard-reports/dashboard"]
  wOps["/dashboard-reports/ops-dashboard"]
  wTaskRep["/dashboard-reports/task-reports"]
  wAssetRep["/dashboard-reports/asset-reports"]
  wSiteRep["/admin-reports"]
  wPlanner --> wManage
  wPlanner -->|"Add Task"| wCreate
  wPlanner -->|"a planned task"| wEditOne
  wManage -->|"a schedule"| wEditAll
  wGroupPlanner -->|"Add Task"| wCreateGroup
  wGroupPlanner -->|"a planned task"| wEditOne
  wAssets --> wAssetList
  wAssetList --> wAsset
  wAssets --> wRegSettings
  wAssetList --> wRegSettings
  wAsset --> wRegSettings
  wAsset -->|"planned tasks +"| wCreateTask
  wAsset -->|"a planned task"| wEditOne
  wDash --> wOps
  wDash --> wTaskRep
  wDash --> wAssetRep
  click wPlanner "screens/planner/planned-tasks.md"
  click wManage "screens/planner/manage-planned-tasks.md"
  click wGroupPlanner "screens/planner/group-planner.md"
  click wCreate "screens/planner/planned-task.md"
  click wCreateGroup "screens/planner/planned-task.md"
  click wCreateTask "screens/planner/planned-task.md"
  click wEditOne "screens/planner/planned-task.md"
  click wEditAll "screens/planner/planned-task.md"
  click wAssets "screens/assets/registers.md"
  click wAssetList "screens/assets/asset-list.md"
  click wAsset "screens/assets/asset-detail.md"
  click wRegSettings "screens/assets/register-settings.md"
  click wDash "screens/reports/dashboard.md"
  click wOps "screens/reports/ops-dashboard.md"
  click wTaskRep "screens/reports/task-reports.md"
  click wAssetRep "screens/reports/asset-reports.md"
  click wSiteRep "screens/reports/site-reports.md"
```

Screens: [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), [Group planner](https://docs.snapfix.com/how-the-apps-work/screens/planner/group-planner.md), [Create planned task](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-task.md) (all five planned-task routes), [Asset registers](https://docs.snapfix.com/how-the-apps-work/screens/assets/registers.md), [Asset list](https://docs.snapfix.com/how-the-apps-work/screens/assets/asset-list.md), [Asset detail](https://docs.snapfix.com/how-the-apps-work/screens/assets/asset-detail.md), [Register settings](https://docs.snapfix.com/how-the-apps-work/screens/assets/register-settings.md), [Dashboard](https://docs.snapfix.com/how-the-apps-work/screens/reports/dashboard.md), [Ops dashboard](https://docs.snapfix.com/how-the-apps-work/screens/reports/ops-dashboard.md), [Task reports](https://docs.snapfix.com/how-the-apps-work/screens/reports/task-reports.md), [Asset reports](https://docs.snapfix.com/how-the-apps-work/screens/reports/asset-reports.md), [Site reports](https://docs.snapfix.com/how-the-apps-work/screens/reports/site-reports.md).

The four Dashboard & Reports routes are tabs of one page. `/plan` and unknown `/plan/...` addresses go to the planner (`src/app/pages/plan/plan.routes.ts:22`); unknown `/dashboard-reports/...` addresses go to the Dashboard (`src/app/pages/dashboard-reports/dashboard-reports.routes.ts:19`). The Ops Dashboard tab is hidden from non-admins, but its route opens for anyone. `/admin-reports` is the side menu's "Site Reports" or "Multi-Site Reports".

### Chat, Comply and Housekeeping

```mermaid
flowchart LR
  wChat["/chat/:id, Chats tab"]
  wNetwork["/chat/:id, My Network tab"]
  wConversation["/chat/:id?chatID=..."]
  wNewGroup["New group dialog"]
  wGroupInfo["Group info panel"]
  wContactInfo["Contact info panel"]
  wMessageInfo["Message info panel"]
  wComply["/comply, Dashboard tab"]
  wTimeline["/comply, Timeline tab"]
  wSystems["/comply, Systems tab"]
  wContractors["/comply, Contractors tab"]
  wFolders["/comply, Folders tab"]
  wSystem["/comply/system/:id"]
  wContractor["/comply/contractor/:id"]
  wHK["/housekeeping"]
  wHKSchedule["Schedule tab"]
  wHKTimeline["Timeline tab"]
  wHKDash["Dashboard tab"]
  wHKSettings["/housekeeping/settings, commented out"]
  wChat --> wNetwork
  wChat --> wConversation
  wNetwork --> wConversation
  wChat -->|"+"| wNewGroup
  wConversation --> wGroupInfo
  wConversation --> wContactInfo
  wConversation -->|"Info"| wMessageInfo
  wComply --> wTimeline
  wComply --> wSystems
  wComply --> wContractors
  wComply --> wFolders
  wSystems --> wSystem
  wContractors --> wContractor
  wTimeline --> wSystem
  wTimeline --> wContractor
  wSystem -->|"contractor chip"| wContractor
  wHK --> wHKSchedule
  wHK --> wHKTimeline
  wHK --> wHKDash
  wHK -.-> wHKSettings
  click wChat "screens/chat/chats.md"
  click wNetwork "screens/chat/contacts.md"
  click wConversation "screens/chat/conversation.md"
  click wNewGroup "screens/chat/new-group.md"
  click wGroupInfo "screens/chat/group-info.md"
  click wContactInfo "screens/chat/contact-info.md"
  click wMessageInfo "screens/chat/message-info.md"
  click wComply "screens/compliance/dashboard.md"
  click wTimeline "screens/compliance/timeline.md"
  click wSystems "screens/compliance/systems.md"
  click wContractors "screens/compliance/contractors.md"
  click wFolders "screens/compliance/folders.md"
  click wSystem "screens/compliance/system-detail.md"
  click wContractor "screens/compliance/contractor-detail.md"
  click wHK "screens/housekeeping/schedule.md"
  click wHKSchedule "screens/housekeeping/schedule.md"
  click wHKTimeline "screens/housekeeping/timeline.md"
  click wHKDash "screens/housekeeping/dashboard.md"
```

Screens: [Chats](https://docs.snapfix.com/how-the-apps-work/screens/chat/chats.md), [Chat contacts](https://docs.snapfix.com/how-the-apps-work/screens/chat/contacts.md), [Conversation](https://docs.snapfix.com/how-the-apps-work/screens/chat/conversation.md), [New group chat](https://docs.snapfix.com/how-the-apps-work/screens/chat/new-group.md), [Group info](https://docs.snapfix.com/how-the-apps-work/screens/chat/group-info.md), [Contact info](https://docs.snapfix.com/how-the-apps-work/screens/chat/contact-info.md), [Message info](https://docs.snapfix.com/how-the-apps-work/screens/chat/message-info.md), [Comply dashboard](https://docs.snapfix.com/how-the-apps-work/screens/compliance/dashboard.md), [Timeline](https://docs.snapfix.com/how-the-apps-work/screens/compliance/timeline.md), [Systems](https://docs.snapfix.com/how-the-apps-work/screens/compliance/systems.md), [Contractors](https://docs.snapfix.com/how-the-apps-work/screens/compliance/contractors.md), [Folders](https://docs.snapfix.com/how-the-apps-work/screens/compliance/folders.md), [System detail](https://docs.snapfix.com/how-the-apps-work/screens/compliance/system-detail.md), [Contractor detail](https://docs.snapfix.com/how-the-apps-work/screens/compliance/contractor-detail.md), [Staff schedule](https://docs.snapfix.com/how-the-apps-work/screens/housekeeping/schedule.md), [Task timeline](https://docs.snapfix.com/how-the-apps-work/screens/housekeeping/timeline.md), [Housekeeping dashboard](https://docs.snapfix.com/how-the-apps-work/screens/housekeeping/dashboard.md).

The Comply and Housekeeping tabs switch inside one page, which opens on the tab last used on the site. Unknown `/comply/...` addresses redirect to `/comply/comply`, which is not a page. The Housekeeping settings pages (roles, staff work, room type, task type) have their routes and their header button commented out, so nothing opens them and they have no screen doc (`src/app/pages/housekeeping/housekeeping.routes.ts:17-27`, `src/app/pages/housekeeping/timeline-board/timeline-board-header/timeline-board-header.component.html:129-137`) \[[ASK-273](https://github.com/snapfix/docs/blob/main/ASK.md#ask-273-should-the-webs-housekeeping-settings-pages-come-back)].

### Site Console, Multi-Site Console and panels

```mermaid
flowchart LR
  wSwitcher["Site switcher, top of the side menu"]
  wConsole["/account/:id"]
  wDetails["/account/:id/details"]
  wStaff["/account/:id/staff"]
  wUsers["/account/:id/manage-users"]
  wRooms["/account/:id/manage-areas-rooms"]
  wTags["/account/:id/manage-tags"]
  wChecklists["/account/:id/manage-checklist"]
  wSub["/account/:id/subscription"]
  wMulti["/multi-site/my_sites"]
  wMsDetails["/multi-site/site_details"]
  wMsUsers["/multi-site/users"]
  wMsChecklists["/multi-site/checklists"]
  wProfile["My Profile drawer"]
  wAI["Snapfix AI panel"]
  wSource["/brand-standards/:documentId"]
  wSnaptips["Take A Quick Tour"]
  wSwitcher -->|"Site Console"| wConsole
  wSwitcher -->|"Site Console, multi-site"| wMulti
  wConsole --> wDetails
  wConsole --> wStaff
  wConsole --> wUsers
  wConsole --> wRooms
  wConsole --> wTags
  wConsole --> wChecklists
  wConsole --> wSub
  wMulti --> wMsDetails
  wMulti --> wMsUsers
  wMulti --> wMsChecklists
  wAI -->|"View document"| wSource
  click wSwitcher "screens/groups/site-switcher.md"
  click wConsole "screens/console/README.md"
  click wDetails "screens/console/site-details.md"
  click wStaff "screens/console/username-sites.md"
  click wUsers "screens/console/users.md"
  click wRooms "screens/rooms/areas-and-rooms.md"
  click wTags "screens/console/tags.md"
  click wChecklists "screens/console/checklists.md"
  click wSub "screens/billing/subscription.md"
  click wMulti "screens/console/my-sites.md"
  click wMsDetails "screens/console/multi-site-details.md"
  click wMsUsers "screens/console/multi-site-users.md"
  click wMsChecklists "screens/console/checklists.md"
  click wProfile "screens/account/profile.md"
  click wAI "screens/ai/assistant.md"
  click wSource "screens/ai/source-document.md"
  click wSnaptips "screens/help/snaptips.md"
```

Screens: [Site switcher](https://docs.snapfix.com/how-the-apps-work/screens/groups/site-switcher.md), [Site console](https://docs.snapfix.com/how-the-apps-work/screens/console.md), [Site details](https://docs.snapfix.com/how-the-apps-work/screens/console/site-details.md), [Username sites](https://docs.snapfix.com/how-the-apps-work/screens/console/username-sites.md), [Users](https://docs.snapfix.com/how-the-apps-work/screens/console/users.md), [Areas and rooms](https://docs.snapfix.com/how-the-apps-work/screens/rooms/areas-and-rooms.md), [Tags](https://docs.snapfix.com/how-the-apps-work/screens/console/tags.md), [Checklists](https://docs.snapfix.com/how-the-apps-work/screens/console/checklists.md) (site and multi-site), [Your subscription](https://docs.snapfix.com/how-the-apps-work/screens/billing/subscription.md), [My sites](https://docs.snapfix.com/how-the-apps-work/screens/console/my-sites.md), [Multi-site details](https://docs.snapfix.com/how-the-apps-work/screens/console/multi-site-details.md), [Multi-site users](https://docs.snapfix.com/how-the-apps-work/screens/console/multi-site-users.md), [My profile](https://docs.snapfix.com/how-the-apps-work/screens/account/profile.md), [Snapfix AI](https://docs.snapfix.com/how-the-apps-work/screens/ai/assistant.md), [Source document](https://docs.snapfix.com/how-the-apps-work/screens/ai/source-document.md), [Snaptips](https://docs.snapfix.com/how-the-apps-work/screens/help/snaptips.md).

The side menu also opens "Site Console" and "Multi-Site Console" directly. The Site Console's tabs and the Multi-Site Console's tabs are routes; unknown tabs go to the first one (`src/app/pages/account-settings/account-settings.routes.ts:26`, `src/app/pages/multisite-console/multisite-console.routes.ts:18`). The My Profile drawer, the Snapfix AI panel and the Snaptips tour (side menu "HelpHub" > "Take A Quick Tour") open over any page. `/brand-standards/:documentId` runs `authMainGuard` but shows outside the app shell, with no side menu (`src/app/app.routes.ts:36-41`).

### Route guards

Routes that run a guard besides `authMainGuard`. What each guard checks is in [Shared behavior](https://docs.snapfix.com/how-the-apps-work/shared.md) and the [web inventory](https://github.com/snapfix/docs/blob/main/notes/inventory/web.md#web_app_v2).

| Route                       | Guards                                                                       | Source                          |
| --------------------------- | ---------------------------------------------------------------------------- | ------------------------------- |
| `/auth/*`                   | `authSigninGuard` (instead of `authMainGuard`)                               | `src/app/app.routes.ts:24-28`   |
| `/delete-user-confirmation` | `authDeleteGuard` (instead of `authMainGuard`)                               | `src/app/app.routes.ts:30-34`   |
| `/admin-reports`            | `authAdminGuard`                                                             | `src/app/app.routes.ts:166-170` |
| `/account/:id` and its tabs | `authAdminGuard`, which checks the current site, not the site in the address | `src/app/app.routes.ts:172-176` |
| `/chat/:id`                 | `authChatGuard`                                                              | `src/app/app.routes.ts:178-182` |
| `/comply` and its children  | `authAdminGuard`, `authComplyGuard`                                          | `src/app/app.routes.ts:184-188` |
| `/multi-site` and its tabs  | `authMultisiteGuard`                                                         | `src/app/app.routes.ts:190-194` |
| `/housekeeping`             | `authAdminGuard`, `authHousekeepingGuard`                                    | `src/app/app.routes.ts:196-200` |

`/account-access` runs no guard (`src/app/app.routes.ts:19-22`).

## Web: other apps

Separate apps on their own hosts, outside the signed-in app shell.

```mermaid
flowchart LR
  tQR["qr.snapfix.com/:id"]
  tSetup["setup.snapfix.com/:id"]
  tTask["task.snapfix.com/:id"]
  tPaySingle["package.snapfix.com/single/:id"]
  tPayMulti["package.snapfix.com/multi/:id"]
  tDeep["dl.snapfix.com, any path"]
  tOps["ops_dashboard_fe, in an iframe"]
  tAccess["web app /account-access"]
  tApps["Snapfix app or app store"]
  tOpsTab["web app Ops Dashboard tab"]
  tDeep -->|"desktop or web view"| tAccess
  tDeep -->|"iOS or Android"| tApps
  tOpsTab --> tOps
  click tQR "screens/qr/form.md"
  click tSetup "screens/onboarding/setup-form.md"
  click tTask "screens/tasks/shared-task.md"
  click tPaySingle "screens/billing/payment-page.md"
  click tPayMulti "screens/billing/payment-page.md"
  click tDeep "screens/account/deep-link.md"
  click tOps "screens/reports/ops-dashboard.md"
  click tAccess "screens/account/account-access.md"
  click tOpsTab "screens/reports/ops-dashboard.md"
```

Screens: [QR form](https://docs.snapfix.com/how-the-apps-work/screens/qr/form.md) (qr\_forms), [Create your Snapfix account](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/setup-form.md) (web\_onboarding\_form), [Shared task](https://docs.snapfix.com/how-the-apps-work/screens/tasks/shared-task.md) (web\_tasks), [Payment page](https://docs.snapfix.com/how-the-apps-work/screens/billing/payment-page.md) (web\_payments, both routes), [Deep link](https://docs.snapfix.com/how-the-apps-work/screens/account/deep-link.md) (dynamic-link), [Ops dashboard](https://docs.snapfix.com/how-the-apps-work/screens/reports/ops-dashboard.md) (ops\_dashboard\_fe), [Account access](https://docs.snapfix.com/how-the-apps-work/screens/account/account-access.md).

* qr\_forms, web\_onboarding\_form, web\_tasks and web\_payments show a not-found page for every other address (qr\_forms @ bdfc4f20a5, `src/app/app-routing.module.ts:17`; web\_onboarding\_form @ 099b91d4e3, `src/app/app.routes.ts:8`; web\_tasks @ 3d85aa7a15, `src/app/app-routing.module.ts:8`; web\_payments @ 7c2c3ddffd, `src/app/app-routing.module.ts:8`).
* dynamic-link shows the same page for `/` and every other path (dynamic-link @ 4d1cd0eb62, `src/app/app.routes.ts:4-13`). It also serves `/.well-known/apple-app-site-association` and `/.well-known/assetlinks.json`, files for app links, not pages.
* ops\_dashboard\_fe has no router: its one page is `index.html`, which web\_app\_v2 shows in an iframe on the Ops Dashboard tab. `embed_test.html` is a developer page with no screen doc (ops\_dashboard\_fe @ bbb2959b3b, `index.html`, `embed_test.html`).

## Staff admin app (webadmin\_angular)

Every page except `/error-page/:code` runs `AuthService.canActivate`. On `/login` it sends a signed-in user to `/`; on every other page it sends a signed-out user to `/login` (webadmin\_angular @ db972390b8, `src/app/services/auth/auth.service.ts:41-57`). Signing in opens `/home` (`src/app/pages/login/login.component.ts:53`), and `/` and unknown addresses go to `/home` (`src/app/app-routing.module.ts:133-136`). The three payment pages also run `PaymentService.checkRestrictionAccess`, which admits only the usernames in a list built into the app and sends anyone else to `/` (`src/app/app-routing.module.ts:44-66`, `src/app/services/payment/payment.service.ts:180-192`). The same list hides the "Survey" menu item from everyone else, but `/survey` itself has no such check (`src/app/app.component.ts:246-259`, `src/app/app-routing.module.ts:122-126`).

```mermaid
flowchart LR
  sLogin["/login"] --> sHome["/home"]
  subgraph sAccounts ["Accounts, groups and users"]
    sAccount["/account"]
    sOrg["/organization-mapping"]
    sGroups["/groups"]
    sGroupUsers["/group-users"]
    sUsers["/users"]
    sTaskMove["/task-move"]
  end
  subgraph sBilling ["Payments and onboarding"]
    sCard["/credit-card-payment"]
    sStripe["/stripe-payment"]
    sPaywall["/paywall"]
    sHubspot["/hubspot-deals"]
    sOnboard["/onboard"]
  end
  subgraph sSupport ["Support, analytics and content"]
    sSupportLogs["/support-logs"]
    sAnalytics["/analytics"]
    sAccountDash["/account-dashboard"]
    sSecurity["/security-dashboard"]
    sGuestline["/guestline"]
    sCs["/cs-dashboard"]
    sMarketing["/marketing-popup"]
    sQr["/qr-management"]
    sSurvey["/survey"]
    sSms["/sms-email-delivery"]
  end
  sError["/error-page/:code"]
  sHome --> sAccounts
  sHome --> sBilling
  sHome --> sSupport
  click sLogin "screens/staff/sign-in.md"
  click sHome "screens/staff/home.md"
  click sAccount "screens/staff/accounts.md"
  click sOrg "screens/staff/org-mapping.md"
  click sGroups "screens/staff/groups.md"
  click sGroupUsers "screens/staff/group-users.md"
  click sUsers "screens/staff/users.md"
  click sTaskMove "screens/staff/task-move.md"
  click sCard "screens/staff/card-payment.md"
  click sStripe "screens/staff/stripe-payment.md"
  click sPaywall "screens/staff/paywall.md"
  click sHubspot "screens/staff/hubspot-deals.md"
  click sOnboard "screens/staff/onboard.md"
  click sSupportLogs "screens/staff/support-logs.md"
  click sAnalytics "screens/staff/analytics.md"
  click sAccountDash "screens/staff/account-dashboard.md"
  click sSecurity "screens/staff/security-dashboard.md"
  click sGuestline "screens/integrations/guestline.md"
  click sCs "screens/staff/cs-dashboard.md"
  click sMarketing "screens/staff/marketing-popups.md"
  click sQr "screens/staff/qr-management.md"
  click sSurvey "screens/staff/surveys.md"
  click sSms "screens/staff/sms-email-delivery.md"
```

Screens: [Staff sign-in](https://docs.snapfix.com/how-the-apps-work/screens/staff/sign-in.md), [Home](https://docs.snapfix.com/how-the-apps-work/screens/staff/home.md), [Accounts](https://docs.snapfix.com/how-the-apps-work/screens/staff/accounts.md), [Organization mapping](https://docs.snapfix.com/how-the-apps-work/screens/staff/org-mapping.md), [Groups](https://docs.snapfix.com/how-the-apps-work/screens/staff/groups.md), [Group users](https://docs.snapfix.com/how-the-apps-work/screens/staff/group-users.md), [Users](https://docs.snapfix.com/how-the-apps-work/screens/staff/users.md), [Task move](https://docs.snapfix.com/how-the-apps-work/screens/staff/task-move.md), [Card payment](https://docs.snapfix.com/how-the-apps-work/screens/staff/card-payment.md), [Stripe payment](https://docs.snapfix.com/how-the-apps-work/screens/staff/stripe-payment.md), [Paywall](https://docs.snapfix.com/how-the-apps-work/screens/staff/paywall.md), [HubSpot deals](https://docs.snapfix.com/how-the-apps-work/screens/staff/hubspot-deals.md), [Onboard](https://docs.snapfix.com/how-the-apps-work/screens/staff/onboard.md), [Support logs](https://docs.snapfix.com/how-the-apps-work/screens/staff/support-logs.md), [Analytics](https://docs.snapfix.com/how-the-apps-work/screens/staff/analytics.md), [Account dashboard](https://docs.snapfix.com/how-the-apps-work/screens/staff/account-dashboard.md), [Security dashboard](https://docs.snapfix.com/how-the-apps-work/screens/staff/security-dashboard.md), [Guestline](https://docs.snapfix.com/how-the-apps-work/screens/integrations/guestline.md), [CS dashboard](https://docs.snapfix.com/how-the-apps-work/screens/staff/cs-dashboard.md), [Marketing popups](https://docs.snapfix.com/how-the-apps-work/screens/staff/marketing-popups.md), [QR management](https://docs.snapfix.com/how-the-apps-work/screens/staff/qr-management.md), [Surveys](https://docs.snapfix.com/how-the-apps-work/screens/staff/surveys.md), [SMS and email delivery](https://docs.snapfix.com/how-the-apps-work/screens/staff/sms-email-delivery.md).

The arrows from Home stand for the side menu, which lists every page; the groups follow its sections. The error page has no screen doc.

## Mobile: launch and sign-in

The order of the launch checks, and what each one needs, is on [Splash](https://docs.snapfix.com/how-the-apps-work/screens/account/splash.md) and in the [mobile inventory](https://github.com/snapfix/docs/blob/main/notes/inventory/mobile.md#launch-flow) (ios @ aa31967ac8, `SnapFix/SplashScreen/SplashScreenVC.swift:259-283`; android @ 86068bfeea, `app/src/main/java/gmail/com/snapfixapp/activity/SplashActivity.java:503-515`). The map shows where each check leads.

```mermaid
flowchart LR
  mSplash["Splash"]
  mBlocked["Device blocked"]
  mSetPw["Set password"]
  mWalk["Walkthrough"]
  mSignIn["Sign in"]
  mForgot["Forgot password"]
  mForgotCode["Forgot password code"]
  mHelp["Login help"]
  mTouch["Get in touch"]
  mSurvey["Pre-registration survey (Android)"]
  mMigration["Data migration (Android)"]
  mDownload["Download data"]
  mStart["Setup: start or join"]
  mCompany["Setup: company and role"]
  mWork["Setup: work types"]
  mLetUs["Setup: let us help"]
  mGrid["Setup: grid or list"]
  mConfig["Configuring Snapfix"]
  mHome["Home"]
  mCamera["Camera"]
  mFirst["First task: pick group (iOS)"]
  mLink["Link with a ctx token"]
  mInvite["Accept invitation"]
  mReset["Reset password from link"]
  mQr["Sign up by QR invitation"]
  mLegacy["Forgot password (legacy)"]
  mSplash -->|"jailbroken or rooted"| mBlocked
  mSplash -->|"temporary password"| mSetPw
  mSplash -->|"walkthrough not seen"| mWalk
  mSplash -->|"signed out"| mSignIn
  mSplash -->|"signed in, no site"| mStart
  mSplash -->|"local data needs migrating"| mMigration
  mSplash -->|"reload pending"| mDownload
  mSplash -->|"signed in"| mHome
  mWalk --> mSignIn
  mSignIn -->|"Forgot password?"| mForgot
  mForgot -->|"SEND ONE-TIME CODE"| mForgotCode
  mSignIn -->|"HelpHub link"| mHelp
  mHelp --> mTouch
  mSignIn -->|"survey comes back"| mSurvey
  mSignIn -->|"temporary password"| mSetPw
  mSignIn -->|"no site"| mStart
  mSignIn --> mDownload
  mDownload --> mHome
  mStart --> mCompany
  mCompany -->|"start a company"| mWork
  mCompany -->|"join"| mGrid
  mWork -->|"Next"| mGrid
  mWork -->|"I don't know yet"| mLetUs
  mLetUs --> mGrid
  mGrid --> mConfig
  mConfig --> mHome
  mHome -->|"Start a task (iOS)"| mCamera
  mCamera --> mFirst
  mLink -->|"invitation"| mInvite
  mLink -->|"reset_password"| mReset
  mLink -->|"qrcode-invitation"| mQr
  mQr -->|"account already exists"| mLegacy
  click mSplash "screens/account/splash.md"
  click mBlocked "screens/account/device-blocked.md"
  click mSetPw "screens/account/set-password.md"
  click mWalk "screens/account/walkthrough.md"
  click mSignIn "screens/account/sign-in.md"
  click mForgot "screens/account/forgot-password.md"
  click mForgotCode "screens/account/forgot-password-code.md"
  click mHelp "screens/help/login-help.md"
  click mTouch "screens/help/get-in-touch.md"
  click mSurvey "screens/onboarding/pre-registration-survey.md"
  click mMigration "screens/account/data-migration.md"
  click mDownload "screens/account/download-data.md"
  click mStart "screens/onboarding/start-or-join.md"
  click mCompany "screens/onboarding/company-and-role.md"
  click mWork "screens/onboarding/work-types.md"
  click mLetUs "screens/onboarding/let-us-help.md"
  click mGrid "screens/onboarding/grid-or-list.md"
  click mConfig "screens/onboarding/configuring.md"
  click mHome "screens/tasks/home.md"
  click mCamera "screens/tasks/camera.md"
  click mFirst "screens/onboarding/first-task.md"
  click mLink "screens/account/deep-link.md"
  click mInvite "screens/account/accept-invitation.md"
  click mReset "screens/account/reset-password.md"
  click mQr "screens/account/qr-sign-up.md"
  click mLegacy "screens/account/legacy-reset.md"
```

Screens: [Splash](https://docs.snapfix.com/how-the-apps-work/screens/account/splash.md), [Device blocked](https://docs.snapfix.com/how-the-apps-work/screens/account/device-blocked.md), [Set password](https://docs.snapfix.com/how-the-apps-work/screens/account/set-password.md), [Walkthrough](https://docs.snapfix.com/how-the-apps-work/screens/account/walkthrough.md), [Sign in](https://docs.snapfix.com/how-the-apps-work/screens/account/sign-in.md), [Forgot password](https://docs.snapfix.com/how-the-apps-work/screens/account/forgot-password.md), [Forgot password code](https://docs.snapfix.com/how-the-apps-work/screens/account/forgot-password-code.md), [Help with logging in](https://docs.snapfix.com/how-the-apps-work/screens/help/login-help.md), [Get in touch](https://docs.snapfix.com/how-the-apps-work/screens/help/get-in-touch.md), [Pre-registration survey](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/pre-registration-survey.md), [Data migration](https://docs.snapfix.com/how-the-apps-work/screens/account/data-migration.md), [Download data](https://docs.snapfix.com/how-the-apps-work/screens/account/download-data.md), [Start or join](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/start-or-join.md), [Company and role](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/company-and-role.md), [Work types](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/work-types.md), [Let us help you](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/let-us-help.md), [Grid or list](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/grid-or-list.md), [Configuring Snapfix](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/configuring.md), [Home](https://docs.snapfix.com/how-the-apps-work/screens/tasks/home.md), [Camera](https://docs.snapfix.com/how-the-apps-work/screens/tasks/camera.md), [First task](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/first-task.md), [Deep link](https://docs.snapfix.com/how-the-apps-work/screens/account/deep-link.md), [Accept invitation](https://docs.snapfix.com/how-the-apps-work/screens/account/accept-invitation.md), [Reset password from link](https://docs.snapfix.com/how-the-apps-work/screens/account/reset-password.md), [Sign up by QR invitation](https://docs.snapfix.com/how-the-apps-work/screens/account/qr-sign-up.md), [Forgot password (legacy)](https://docs.snapfix.com/how-the-apps-work/screens/account/legacy-reset.md).

* **Links.** On iOS the link handler opens the invitation, reset and QR screens itself, as the new root screen (ios @ aa31967ac8, `Managers/DeepLink/DynamicLinkContextDeeplinkHandler.swift:233-256`). On Android, Sign in opens them; the deep-link handler also opens the QR sign-up (android @ 86068bfeea, `app/src/main/java/gmail/com/snapfixapp/activity/LoginActivity.kt:409`, `:449-451`; `app/src/main/java/gmail/com/snapfixapp/activity/DeepLinkHandlerActivity.kt:177`). On Android a link opens Splash first ([Splash](https://docs.snapfix.com/how-the-apps-work/screens/account/splash.md)).
* **Login help.** On iOS the "HelpHub" link opens the [FAQ](https://docs.snapfix.com/how-the-apps-work/screens/help/faq.md) screen in its signed-out form; Android has its own login help screen ([Help with logging in](https://docs.snapfix.com/how-the-apps-work/screens/help/login-help.md)).
* **First task.** Only iOS opens it: after a setup that started a company, the "Start a task" popup over Home opens the camera, and the first task's group is picked here. Android has the screen, but nothing opens it ([First task](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/first-task.md)).
* **Pre-registration survey.** Only Android shows it; iOS requests it only from a sign-in screen it never opens.

## Mobile: Home, top bar and side menu

Home is the frame around every main page: the bottom bar (Snap, Fix, Chat, Plan), the top bar (profile photo, site, Snapfix AI, "+") and the side menu behind the profile photo. Each item is listed in [Home](https://docs.snapfix.com/how-the-apps-work/screens/tasks/home.md). Snap opens the camera and never stays selected (ios @ aa31967ac8, `SnapFix/HomeTabbarC.swift:307-312`). Android also has Track and Comply tabs in the bar's layout, both hidden (android @ 86068bfeea, `app/src/main/res/layout/master_bottom_bar.xml:332-334`, `:388-390`) \[[ASK-10](https://github.com/snapfix/docs/blob/main/ASK.md#ask-10-which-differences-between-the-ios-and-android-apps-are-intended)].

```mermaid
flowchart LR
  mHome["Home"]
  mFix["Fix tab"]
  mChat["Chat tab"]
  mPlan["Plan tab"]
  mCamera["Camera"]
  mPhoto["Photo edit and name"]
  mText["Text or sketch task"]
  mVoice["Voice task"]
  mPick["Add task to a group"]
  mSwitcher["Site switcher"]
  mAI["Snapfix AI"]
  mSource["AI source document"]
  mCreateGroup["Create group"]
  mAddUser["Add a New User sheet"]
  mProfile["Profile hub: My Profile"]
  mNotif["Profile hub: Notifications"]
  mSettings["Profile hub: Settings"]
  mPlanChoice["Choose plan (iOS)"]
  mHelpHub["Profile hub: Help Hub"]
  mFaq["FAQ"]
  mTouch["Get in touch"]
  mSnaptips["Snaptips"]
  mVideos["Help videos"]
  mSiteDetails["Site details"]
  mSiteUsers["Site users"]
  mDownload["Download data"]
  mHome -->|"Snap"| mCamera
  mHome -->|"Fix"| mFix
  mHome -->|"Chat"| mChat
  mHome -->|"Plan"| mPlan
  mHome -->|"site logo"| mSwitcher
  mHome -->|"Snapfix AI"| mAI
  mAI -->|"View document"| mSource
  mHome -->|"+ Create a new task"| mCamera
  mHome -->|"+ Create a new Voice Task"| mVoice
  mHome -->|"+ Create a new Group"| mCreateGroup
  mHome -->|"+ Add a New User"| mAddUser
  mCamera --> mPhoto
  mCamera -->|"Text, Sketch"| mText
  mPhoto --> mPick
  mText --> mPick
  mVoice --> mPick
  mHome -->|"side menu, profile card"| mProfile
  mProfile --- mNotif
  mHome -->|"side menu, Settings"| mSettings
  mSettings -->|"Subscriptions"| mPlanChoice
  mHome -->|"side menu, HelpHub"| mHelpHub
  mHelpHub --> mFaq
  mHelpHub --> mTouch
  mHelpHub --> mSnaptips
  mHelpHub --> mVideos
  mHome -->|"side menu, Site Details"| mSiteDetails
  mHome -->|"side menu, Users"| mSiteUsers
  mHome -->|"side menu, Reload"| mDownload
  click mHome "screens/tasks/home.md"
  click mFix "screens/tasks/fix.md"
  click mChat "screens/chat/chats.md"
  click mPlan "screens/planner/plan.md"
  click mCamera "screens/tasks/camera.md"
  click mPhoto "screens/tasks/photo-edit.md"
  click mText "screens/tasks/text-task.md"
  click mVoice "screens/tasks/voice-task.md"
  click mPick "screens/tasks/pick-group.md"
  click mSwitcher "screens/groups/site-switcher.md"
  click mAI "screens/ai/assistant.md"
  click mSource "screens/ai/source-document.md"
  click mCreateGroup "screens/groups/create-group.md"
  click mAddUser "screens/console/users.md"
  click mProfile "screens/account/profile.md"
  click mNotif "screens/notifications/settings.md"
  click mSettings "screens/account/app-settings.md"
  click mPlanChoice "screens/billing/choose-plan.md"
  click mHelpHub "screens/help/help-hub.md"
  click mFaq "screens/help/faq.md"
  click mTouch "screens/help/get-in-touch.md"
  click mSnaptips "screens/help/snaptips.md"
  click mVideos "screens/help/help-videos.md"
  click mSiteDetails "screens/console/site-details.md"
  click mSiteUsers "screens/console/users.md"
  click mDownload "screens/account/download-data.md"
```

Screens: [Home](https://docs.snapfix.com/how-the-apps-work/screens/tasks/home.md), [Fix](https://docs.snapfix.com/how-the-apps-work/screens/tasks/fix.md), [Chats](https://docs.snapfix.com/how-the-apps-work/screens/chat/chats.md), [Plan](https://docs.snapfix.com/how-the-apps-work/screens/planner/plan.md), [Camera](https://docs.snapfix.com/how-the-apps-work/screens/tasks/camera.md), [Photo edit and name](https://docs.snapfix.com/how-the-apps-work/screens/tasks/photo-edit.md), [Text or sketch task](https://docs.snapfix.com/how-the-apps-work/screens/tasks/text-task.md), [Voice task](https://docs.snapfix.com/how-the-apps-work/screens/tasks/voice-task.md), [Add task to a group](https://docs.snapfix.com/how-the-apps-work/screens/tasks/pick-group.md), [Site switcher](https://docs.snapfix.com/how-the-apps-work/screens/groups/site-switcher.md), [Snapfix AI](https://docs.snapfix.com/how-the-apps-work/screens/ai/assistant.md), [Source document](https://docs.snapfix.com/how-the-apps-work/screens/ai/source-document.md), [Create group](https://docs.snapfix.com/how-the-apps-work/screens/groups/create-group.md), [Users](https://docs.snapfix.com/how-the-apps-work/screens/console/users.md) (the "Add a new user" sheet), [My profile](https://docs.snapfix.com/how-the-apps-work/screens/account/profile.md), [Notification settings](https://docs.snapfix.com/how-the-apps-work/screens/notifications/settings.md), [App settings](https://docs.snapfix.com/how-the-apps-work/screens/account/app-settings.md), [Choose plan](https://docs.snapfix.com/how-the-apps-work/screens/billing/choose-plan.md), [Help Hub](https://docs.snapfix.com/how-the-apps-work/screens/help/help-hub.md), [FAQ](https://docs.snapfix.com/how-the-apps-work/screens/help/faq.md), [Get in touch](https://docs.snapfix.com/how-the-apps-work/screens/help/get-in-touch.md), [Snaptips](https://docs.snapfix.com/how-the-apps-work/screens/help/snaptips.md), [Help videos](https://docs.snapfix.com/how-the-apps-work/screens/help/help-videos.md), [Site details](https://docs.snapfix.com/how-the-apps-work/screens/console/site-details.md).

* The "+" menu above is the one on the Fix pages. On the asset registers it offers the scan, new asset and new register items instead ([Mobile: Plan tab](#mobile-plan-tab)), and on other pages it acts at once ([Home](https://docs.snapfix.com/how-the-apps-work/screens/tasks/home.md#the--menu)).
* The profile hub is one screen with four tabs: "Notifications", "My Profile", "Settings" and "Help Hub". The side menu opens it on My Profile, Settings or Help Hub; Notifications is reached by its tab. The hub has no doc of its own.
* "Site Administration" opens the Site Console (Site details and Users). iOS shows it to every member, with "Users" only for site admins; Android gives non-admins "Site Details" alone ([Home](https://docs.snapfix.com/how-the-apps-work/screens/tasks/home.md#side-menu)).
* The side menu's "Plan", "Assets", "Comply" and "Housekeeping" open the Plan tab at that page.

## Mobile: Fix tab

iOS opens five pages under Fix: Feed, Groups, Room Tasks, Room Status and Areas, starting on Groups (ios @ aa31967ac8, `SnapFix/FixTabPageViewController.swift:27-31`, `:126`). Android opens the Fix tab last used on the site, from Feed, Groups, Room Tasks, Areas and Housekeeping ([Fix](https://docs.snapfix.com/how-the-apps-work/screens/tasks/fix.md), [Task timeline](https://docs.snapfix.com/how-the-apps-work/screens/housekeeping/timeline.md)). The tab buttons read "Feed", "Groups", "Room Tasks" (or "Room Status") and "Areas" on both.

```mermaid
flowchart LR
  mFix["Fix tab"]
  mFeed["Feed"]
  mGroups["Groups"]
  mRoomTasks["Room Tasks"]
  mRoomStatus["Room Status"]
  mAreas["Areas"]
  mHK["Housekeeping timeline (Android)"]
  mApproval["Approval activity"]
  mCreateGroup["Create group"]
  mAddUsers["Add users to a group (iOS)"]
  mPurpose["Group purpose"]
  mGroupTasks["Group tasks"]
  mGroupSettings["Group settings"]
  mFindUser["Find user to add"]
  mPhoneContacts["Add from phone contacts (Android)"]
  mQR["Group QR codes"]
  mPlanner["Group planner"]
  mAnalytics["Analytics"]
  mLegacyDash["Legacy dashboard (iOS)"]
  mRoom["Room"]
  mRoomInfo["Room info"]
  mArea["Area"]
  mAreaInfo["Area info"]
  mTask["Task detail"]
  mActivity["Task activity"]
  mCopyMove["Copy or move task"]
  mGallery["Gallery"]
  mChecklist["Checklist"]
  mEditChecklist["Edit checklist"]
  mSelectAsset["Select asset"]
  mCreatePlanned["Create planned task"]
  mFix --> mFeed
  mFix --> mGroups
  mFix --> mRoomTasks
  mFix --> mRoomStatus
  mFix --> mAreas
  mFix -->|"last used"| mHK
  mFeed --> mTask
  mFeed --> mApproval
  mGroups --> mGroupTasks
  mGroups --> mCreateGroup
  mGroups -->|"add-user button (iOS)"| mAddUsers
  mGroups --> mPurpose
  mGroups --> mGroupSettings
  mCreateGroup -->|"saved (Android)"| mPhoneContacts
  mCreateGroup -->|"new group banner (iOS)"| mGroupSettings
  mAddUsers -->|"group picked, Users tab"| mGroupSettings
  mPurpose --> mGroupSettings
  mGroupTasks --> mTask
  mGroupTasks --> mApproval
  mGroupTasks --> mPurpose
  mGroupTasks --> mGroupSettings
  mGroupTasks --> mQR
  mGroupTasks -->|"Planned Tasks"| mPlanner
  mGroupTasks -->|"Analytics"| mAnalytics
  mGroupTasks -->|"Dashboard"| mLegacyDash
  mGroupSettings -->|"Users tab, add"| mFindUser
  mGroupSettings --> mQR
  mRoomTasks --> mRoom
  mRoomStatus -->|"room card"| mRoom
  mRoom -->|"header"| mRoomInfo
  mRoom --> mTask
  mAreas --> mArea
  mArea -->|"header"| mAreaInfo
  mArea --> mTask
  mTask --> mActivity
  mTask --> mCopyMove
  mTask --> mGallery
  mTask --> mChecklist
  mChecklist --> mEditChecklist
  mTask --> mSelectAsset
  mTask -->|"Create Planned Tasks"| mCreatePlanned
  mPlanner --> mCreatePlanned
  click mFix "screens/tasks/fix.md"
  click mFeed "screens/tasks/feed.md"
  click mGroups "screens/groups/group-list.md"
  click mRoomTasks "screens/rooms/room-tasks.md"
  click mRoomStatus "screens/rooms/room-status.md"
  click mAreas "screens/rooms/areas.md"
  click mHK "screens/housekeeping/timeline.md"
  click mApproval "screens/tasks/approval-activity.md"
  click mCreateGroup "screens/groups/create-group.md"
  click mAddUsers "screens/groups/add-users.md"
  click mPurpose "screens/groups/group-purpose.md"
  click mGroupTasks "screens/tasks/group-tasks.md"
  click mGroupSettings "screens/groups/group-settings.md"
  click mFindUser "screens/groups/find-user.md"
  click mPhoneContacts "screens/groups/phone-contacts.md"
  click mQR "screens/groups/qr-codes.md"
  click mPlanner "screens/planner/group-planner.md"
  click mAnalytics "screens/reports/analytics.md"
  click mLegacyDash "screens/reports/legacy-dashboard.md"
  click mRoom "screens/rooms/room.md"
  click mRoomInfo "screens/rooms/room-info.md"
  click mArea "screens/rooms/area.md"
  click mAreaInfo "screens/rooms/area-info.md"
  click mTask "screens/tasks/task-detail.md"
  click mActivity "screens/tasks/task-activity.md"
  click mCopyMove "screens/tasks/copy-move.md"
  click mGallery "screens/tasks/gallery.md"
  click mChecklist "screens/checklists/checklist.md"
  click mEditChecklist "screens/checklists/edit-checklist.md"
  click mSelectAsset "screens/assets/select-asset.md"
  click mCreatePlanned "screens/planner/planned-task.md"
```

Screens: [Fix](https://docs.snapfix.com/how-the-apps-work/screens/tasks/fix.md), [Feed](https://docs.snapfix.com/how-the-apps-work/screens/tasks/feed.md), [Group list](https://docs.snapfix.com/how-the-apps-work/screens/groups/group-list.md), [Room tasks](https://docs.snapfix.com/how-the-apps-work/screens/rooms/room-tasks.md), [Room status](https://docs.snapfix.com/how-the-apps-work/screens/rooms/room-status.md), [Areas](https://docs.snapfix.com/how-the-apps-work/screens/rooms/areas.md), [Task timeline](https://docs.snapfix.com/how-the-apps-work/screens/housekeeping/timeline.md), [Approval activity](https://docs.snapfix.com/how-the-apps-work/screens/tasks/approval-activity.md), [Create group](https://docs.snapfix.com/how-the-apps-work/screens/groups/create-group.md), [Add users to a group](https://docs.snapfix.com/how-the-apps-work/screens/groups/add-users.md), [Group purpose](https://docs.snapfix.com/how-the-apps-work/screens/groups/group-purpose.md), [Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md), [Group settings](https://docs.snapfix.com/how-the-apps-work/screens/groups/group-settings.md), [Find user to add](https://docs.snapfix.com/how-the-apps-work/screens/groups/find-user.md), [Add from phone contacts](https://docs.snapfix.com/how-the-apps-work/screens/groups/phone-contacts.md), [Group QR codes](https://docs.snapfix.com/how-the-apps-work/screens/groups/qr-codes.md), [Group planner](https://docs.snapfix.com/how-the-apps-work/screens/planner/group-planner.md), [Analytics](https://docs.snapfix.com/how-the-apps-work/screens/reports/analytics.md), [Legacy dashboard](https://docs.snapfix.com/how-the-apps-work/screens/reports/legacy-dashboard.md), [Room](https://docs.snapfix.com/how-the-apps-work/screens/rooms/room.md), [Room info](https://docs.snapfix.com/how-the-apps-work/screens/rooms/room-info.md), [Area](https://docs.snapfix.com/how-the-apps-work/screens/rooms/area.md), [Area info](https://docs.snapfix.com/how-the-apps-work/screens/rooms/area-info.md), [Task detail](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md), [Task activity](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-activity.md), [Copy or move](https://docs.snapfix.com/how-the-apps-work/screens/tasks/copy-move.md), [Gallery](https://docs.snapfix.com/how-the-apps-work/screens/tasks/gallery.md), [Checklist](https://docs.snapfix.com/how-the-apps-work/screens/checklists/checklist.md), [Edit checklist](https://docs.snapfix.com/how-the-apps-work/screens/checklists/edit-checklist.md), [Select asset](https://docs.snapfix.com/how-the-apps-work/screens/assets/select-asset.md), [Create planned task](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-task.md).

* A group opens Group tasks, which switches between list, grid, analytics, planner and settings from its view menu (iOS) or the "Group view" sheet (Android). Rooms and areas open the same screen for their tasks ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md#rooms-and-areas)).
* On Android, "Room Status" is the "Room Tasks" chip tapped again ([Room status](https://docs.snapfix.com/how-the-apps-work/screens/rooms/room-status.md)).
* People join a group from its settings' Users tab, which opens [Find user to add](https://docs.snapfix.com/how-the-apps-work/screens/groups/find-user.md). iOS also gets there through Add users to a group, which picks the group first; Android's copy of that screen never opens ([Not reachable](#not-reachable-or-not-drawn)).
* A task opens inside the task pager, which swipes between tasks ([Task detail](https://docs.snapfix.com/how-the-apps-work/screens/tasks/task-detail.md)).

## Mobile: Chat tab

```mermaid
flowchart LR
  mChat["Chat tab"]
  mChats["Chats"]
  mMyNetwork["My network"]
  mContacts["Chat contacts"]
  mNewGroup["New group chat"]
  mConversation["Conversation"]
  mGroupInfo["Group info"]
  mContactInfo["Contact info"]
  mMessageInfo["Message info"]
  mAddUsers["Add users to a group (iOS)"]
  mChat -->|"chat on"| mChats
  mChat -->|"chat off"| mMyNetwork
  mChats -->|"MY NETWORK, or My Network chip"| mContacts
  mChats -->|"+"| mNewGroup
  mChats --> mConversation
  mContacts --> mConversation
  mConversation --> mGroupInfo
  mConversation --> mContactInfo
  mConversation -->|"Info"| mMessageInfo
  mMyNetwork -->|"Add To Group"| mAddUsers
  click mChat "screens/chat/chats.md"
  click mChats "screens/chat/chats.md"
  click mMyNetwork "screens/chat/my-network.md"
  click mContacts "screens/chat/contacts.md"
  click mNewGroup "screens/chat/new-group.md"
  click mConversation "screens/chat/conversation.md"
  click mGroupInfo "screens/chat/group-info.md"
  click mContactInfo "screens/chat/contact-info.md"
  click mMessageInfo "screens/chat/message-info.md"
  click mAddUsers "screens/groups/add-users.md"
```

Screens: [Chats](https://docs.snapfix.com/how-the-apps-work/screens/chat/chats.md), [My network](https://docs.snapfix.com/how-the-apps-work/screens/chat/my-network.md), [Chat contacts](https://docs.snapfix.com/how-the-apps-work/screens/chat/contacts.md), [New group chat](https://docs.snapfix.com/how-the-apps-work/screens/chat/new-group.md), [Conversation](https://docs.snapfix.com/how-the-apps-work/screens/chat/conversation.md), [Group info](https://docs.snapfix.com/how-the-apps-work/screens/chat/group-info.md), [Contact info](https://docs.snapfix.com/how-the-apps-work/screens/chat/contact-info.md), [Message info](https://docs.snapfix.com/how-the-apps-work/screens/chat/message-info.md), [Add users to a group](https://docs.snapfix.com/how-the-apps-work/screens/groups/add-users.md).

iOS shows a "CHATS" / "MY NETWORK" toggle; Android shows the chips "All", "My Chats", "Group Chats", "My Network" and "Archived" (android @ 86068bfeea, `app/src/main/res/layout/fragment_home_chat.xml:132-180`). On a site with chat off, the Chat icon opens My network instead.

## Mobile: Plan tab

iOS has five Plan pages: planned tasks, schedules, asset registers, Comply and the housekeeping timeline (ios @ aa31967ac8, `SnapFix/Scheduler Tab/SchedulerPageViewController.swift:144`). Android shows the chips "Planned Tasks", "Asset registers", "Comply" and "Housekeeping" (android @ 86068bfeea, `app/src/main/res/layout/fragment_asset_group_listing.xml:259-298`). On both, tapping "Planned Tasks" again switches to the schedules ([Plan](https://docs.snapfix.com/how-the-apps-work/screens/planner/plan.md)).

```mermaid
flowchart LR
  mPlan["Plan tab"]
  mPlanned["Planned tasks"]
  mSchedules["Manage planned tasks"]
  mCreatePlanned["Create planned task"]
  mRegisters["Asset registers"]
  mAssetList["Asset list"]
  mAsset["Asset detail"]
  mAttributes["Asset attributes"]
  mScanner["Code scanner"]
  mCreateRegister["Create asset register"]
  mRegSettings["Register settings"]
  mComply["Comply notice"]
  mHK["Housekeeping timeline"]
  mPlan --> mPlanned
  mPlan --> mRegisters
  mPlan --> mComply
  mPlan --> mHK
  mPlanned -->|"Planned Tasks again"| mSchedules
  mPlanned -->|"+"| mCreatePlanned
  mSchedules -->|"a schedule"| mCreatePlanned
  mRegisters --> mAssetList
  mRegisters -->|"+ Create a new asset register"| mCreateRegister
  mRegisters -->|"settings on a row"| mRegSettings
  mRegisters -->|"scan"| mScanner
  mAssetList --> mAsset
  mAssetList -->|"scan"| mScanner
  mAssetList -->|"menu (Android)"| mRegSettings
  mScanner -->|"View Asset"| mAsset
  mAsset -->|"Attributes"| mAttributes
  click mPlan "screens/planner/plan.md"
  click mPlanned "screens/planner/planned-tasks.md"
  click mSchedules "screens/planner/manage-planned-tasks.md"
  click mCreatePlanned "screens/planner/planned-task.md"
  click mRegisters "screens/assets/registers.md"
  click mAssetList "screens/assets/asset-list.md"
  click mAsset "screens/assets/asset-detail.md"
  click mAttributes "screens/assets/asset-attributes.md"
  click mScanner "screens/assets/code-scanner.md"
  click mCreateRegister "screens/assets/create-register.md"
  click mRegSettings "screens/assets/register-settings.md"
  click mComply "screens/compliance/mobile-notice.md"
  click mHK "screens/housekeeping/timeline.md"
```

Screens: [Plan](https://docs.snapfix.com/how-the-apps-work/screens/planner/plan.md), [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), [Create planned task](https://docs.snapfix.com/how-the-apps-work/screens/planner/planned-task.md), [Asset registers](https://docs.snapfix.com/how-the-apps-work/screens/assets/registers.md), [Asset list](https://docs.snapfix.com/how-the-apps-work/screens/assets/asset-list.md), [Asset detail](https://docs.snapfix.com/how-the-apps-work/screens/assets/asset-detail.md), [Asset attributes](https://docs.snapfix.com/how-the-apps-work/screens/assets/asset-attributes.md), [Code scanner](https://docs.snapfix.com/how-the-apps-work/screens/assets/code-scanner.md), [Create asset register](https://docs.snapfix.com/how-the-apps-work/screens/assets/create-register.md), [Register settings](https://docs.snapfix.com/how-the-apps-work/screens/assets/register-settings.md), [Comply notice](https://docs.snapfix.com/how-the-apps-work/screens/compliance/mobile-notice.md), [Task timeline](https://docs.snapfix.com/how-the-apps-work/screens/housekeeping/timeline.md).

A new asset starts with the camera, from the asset registers' "+" menu ("Create a new asset"), and then opens [Asset attributes](https://docs.snapfix.com/how-the-apps-work/screens/assets/asset-attributes.md). Comply itself lives on the web; the apps show only a notice.

## Not reachable or not drawn

Code that exists but that nothing opens, and screens with no doc. The full lists are in the inventories: [web](https://github.com/snapfix/docs/blob/main/notes/inventory/web.md#not-reachable) and [mobile](https://github.com/snapfix/docs/blob/main/notes/inventory/mobile.md#unused), which counts 53 unused iOS classes, five groups of iOS files outside the build target, and 108 unused Android classes.

* **Web sign-up.** There is no sign-up route: `/auth/sign-up` falls to the auth wildcard and lands on Sign in. The sign-up steps, the welcome dialog and the pre-registration survey dialog open only from that unrouted page.
* **Web dialogs.** The share invitation dialog and the "My Sites" drawer have no caller ([web inventory](https://github.com/snapfix/docs/blob/main/notes/inventory/web.md#not-reachable)).
* **Web Housekeeping settings.** Commented out, no screen doc ([Chat, Comply and Housekeeping](#chat-comply-and-housekeeping)).
* **Staff error page** (`/error-page/:code`) and the ops\_dashboard\_fe page `embed_test.html`: reachable by address, no screen doc.
* **iOS legacy sign-up.** [Create account (legacy)](https://docs.snapfix.com/how-the-apps-work/screens/account/create-account.md) opens from a button that no storyboard connects and from a sign-in screen the app never shows.
* **iOS login code.** [Login code](https://docs.snapfix.com/how-the-apps-work/screens/account/login-code.md) (`SmsEmailOtpVC`) has no current path in; on the web the same step runs inside the mini sign-in dialog.
* **iOS surveys.** The [NPS survey](https://docs.snapfix.com/how-the-apps-work/screens/notifications/nps-survey.md) and the [product feedback survey](https://docs.snapfix.com/how-the-apps-work/screens/notifications/feedback-survey.md) would open over the group list, but their trigger is commented out \[[ASK-10](https://github.com/snapfix/docs/blob/main/ASK.md#ask-10-which-differences-between-the-ios-and-android-apps-are-intended)].
* **Android first task.** [First task](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/first-task.md) exists on Android but never opens.
* **Android add users to a group.** `AddUserToGroupActivity` opens only from the old groups "+" sheet and the old guides page. The sheet's "+" buttons sit in fragment headers that are hidden, and the guides tab's click is commented out, so the screen never opens; the top bar's "+" offers "Add a New User" instead (android @ 86068bfeea, `app/src/main/java/gmail/com/snapfixapp/activity/BusinessListingActivity.java:1644-1646`, `:1726`, `:3982-3984`; `app/src/main/res/layout/fragment_group_listing.xml:108-115`, `:159-165`) \[[ASK-280](https://github.com/snapfix/docs/blob/main/ASK.md#ask-280-should-android-still-offer-add-users-to-a-group)].
* **Android Track and Comply tabs.** Hidden in the bottom bar layout \[[ASK-10](https://github.com/snapfix/docs/blob/main/ASK.md#ask-10-which-differences-between-the-ios-and-android-apps-are-intended)].
* **No screen doc.** The mobile side menu and profile hub (covered by [Home](https://docs.snapfix.com/how-the-apps-work/screens/tasks/home.md) and the tab docs), the mobile Site Console container (its tabs are [Site details](https://docs.snapfix.com/how-the-apps-work/screens/console/site-details.md) and [Users](https://docs.snapfix.com/how-the-apps-work/screens/console/users.md)), the image crop step of the photo pickers, and the Android video player.


---

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