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

# Snaptips

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

Short guided tours that point at the main menu items or tabs and say what each one is for.

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

* **Where:**
  * Web: side menu "HelpHub" > "Take A Quick Tour" opens the "NEW!" dialog, and "Explore now!" starts the tour. A new web sign-up also opens the dialog, 1.5 seconds after the account is made, as the app opens `/fix` (web\_app\_v2 @ 0989b8e685, `src/app/components/side-menu/side-menu.component.ts:367-374`, `:625-627`, `src/app/pages/auth/sign-up/sign-up.component.ts:149-155`).
  * iOS: Help Hub > "Snaptips" opens a page with one card, "Getting Started Quick Tour". The card switches to the Fix tab's group list and shows the "QUICK TOUR" start card (ios @ aa31967ac8, `SnapFix/SnapTipsVC.swift:35-55`, `SnapFix/BusinessListingVC+HelpHub.swift:11-23`, `SnapFix/FixTabPageViewController.swift:205-211`).
  * Android: Help Hub > "Snaptips" opens a page with one card, "GETTING STARTED QUICK TOUR". The card opens the group list with the "QUICK TOUR" dialog (android @ 86068bfeea, `app/src/main/java/gmail/com/snapfixapp/activity/MyProfileActivity.kt:2659-2676`, `app/src/main/java/gmail/com/snapfixapp/activity/BusinessListingActivity.java:399-403`, `:4352-4354`).
  * After a new account is made, iOS and Android offer a shorter [welcome tour](#welcome-tour-ios-and-android).
* **Who:** every signed-in user. On the web the steps depend on the role and on whether a multi-site is selected ([Web tour steps](#web-tour-steps)). The app tours are the same for everyone.
* **Feature:** [Quick tour](https://docs.snapfix.com/product/features/help/quick-tour.md)

```mermaid
flowchart LR
  A[Web side menu: Take A Quick Tour] --> D[NEW! dialog]
  B[New web sign-up] --> D
  D -->|Explore now!| T[Web tour]
  H[App Help Hub: Snaptips card] --> S[QUICK TOUR card or dialog]
  S -->|Start| W[Six-card app tour]
  R[New account in the apps] --> P[Welcome popup or sheet]
  P -->|Take a Quick Tour| WC[SNAP and FIX cards]
  WC --> DN[Done! popup or sheet]
  DN -->|Learn More| HH[Help Hub]
```

## Layout

### Web dialog

1. **Close.** A close button at the top right.
2. **Title.** "NEW!"; with a multi-site selected, "NEW! - Multi-site".
3. **Text.** Single site: "Snapfix has a new layout to make your experience even better." and "Enjoy all the features you love, in a structured and intuitive design." Multi-site: "Snapfix has a new role for Multi-site users to make managing all your sites easier than ever." and "Enjoy all the features you love, now in a more structured and intuitive experience."
4. **Buttons.** "Explore now!" and the link "Show me later".

A click outside the dialog or the Escape key does not close it (`src/app/components/snaptips/snaptips-dialog/snaptips-dialog.component.html:1-48`, `src/app/services/snaptips/snaptips.service.ts:94-104`).

### Web tour

One card at a time, placed at the side-menu item it describes: a progress bar, a close button, a title in capitals ending in "!", one or more lines, and "NEXT"; the last card has "DONE". There is no back button. The progress bar shows the card's place among the steps the user gets (`src/app/components/snaptips/snaptips-tour/snaptips-tour.component.html:1-314`, `snaptips.service.ts:42-54`).

#### Web tour steps

The step numbers are the code's. Each step shows only when its rule passes (`snaptips.service.ts:56-92`, `:176-228`); the texts are the `SNAPTIPS` keys of `public/i18n/en.json`.

| Step | Points at                  | Title                                    | Shown when                                                                              | Text                                                                                                                                                                                                                                                                                                                                             |
| ---- | -------------------------- | ---------------------------------------- | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 2    | Fix                        | "FIX!"                                   | Always                                                                                  | "Manage your Tasks using our Feed, Groups and Rooms/Areas." Multi-site: "Use Feed to see all your tasks across sites.", "Select a site to view Groups and Rooms/Areas too.", "If you want to make updates to a Site, you can set yourself as a Site Admin." and "If you want to make updates in a Group, you can set yourself as a Group Admin." |
| 3    | Plan                       | "PLAN!"                                  | Always                                                                                  | "Plan and manage your Planned Tasks, Assets and Compliance." Multi-site: "Select a site to manage your planned tasks, assets, and compliance."                                                                                                                                                                                                   |
| 4    | Assets                     | "ASSETS!"                                | Always                                                                                  | "Manage your assets, equipment and vehicles in a Snap."                                                                                                                                                                                                                                                                                          |
| 5    | Comply                     | "COMPLY!"                                | Role "Admin"                                                                            | "Always Be Compliant (ABC) and reduce risk with our COMPLY module."                                                                                                                                                                                                                                                                              |
| 6    | Chat                       | "CHAT!"                                  | No multi-site selected, and chat on for the site (on when the site has no chat setting) | "Chat 1:1 and in Groups with your Team."                                                                                                                                                                                                                                                                                                         |
| 7    | Dashboard and reports      | "DASHBOARD & REPORTS!"                   | Always                                                                                  | "Dashboard with a clear overview of all your tasks." and "Task Reports and Asset Reports to track progress and status." Multi-site: "Site dashboard and reports for visibility, accountability and control." and "Track progress and status across tasks and assets."                                                                            |
| 8    | Site Console               | "SITE CONSOLE!"                          | No multi-site selected, and role "Admin" or a group admin                               | "Update site details.", "Add and remove site admins." and "Set up and organize rooms and areas." On a site with chat off the card is blank: only the progress bar and the close button show, with no "NEXT".                                                                                                                                     |
| 9    | Multi-site console         | "MULTI-SITE CONSOLE!"                    | A multi-site selected                                                                   | "View all your sites in one place.", then "Update site details", "Add or remove site admins" and "Setup and organize rooms, areas, and checklists".                                                                                                                                                                                              |
| 10   | Site or multi-site reports | "SITE REPORTS!" or "MULTI-SITE REPORTS!" | A multi-site selected, or role "Admin"                                                  | "View reports from your site in one consolidated view." Multi-site: "View reports from all your sites in one consolidated view."                                                                                                                                                                                                                 |
| 11   | The "HelpHub" item         | "TAKE A QUICK TOUR!"                     | Always                                                                                  | "Feeling stuck or can't remember how something works?" and "You can revisit the Quick Tour anytime to refresh your memory on Snapfix's key features." The button is "DONE".                                                                                                                                                                      |

On 2026-11-14, as role "Admin" of a single site with chat on, the live tour showed steps 2 to 8, 10 and 11, as the rules say.

### iOS Snaptips page

1. **Header.** "SNAPTIPS" with a back button.
2. **Title and intro.** "Snaptips" and "Explore helpful tips to enhance your experience. These quick tips will guide you through useful features and shortcuts to make the most of the app."
3. **Card.** "Getting Started Quick Tour" with "Take a quick tour to get familiar with the app’s main features." (`SnapFix/SnapTipsVC.swift:35-42`).

### iOS start card

Over the dimmed group list: the title "QUICK TOUR", "Let’s take a look at the Snapfix main screen.", a "Start" button and a close button (`SnapFix/SnapTipsView.swift:233-257`).

### Android Snaptips page

The title "Snaptips", the same intro as iOS, and one card, "GETTING STARTED QUICK TOUR", with the same text (`app/src/main/res/layout/layout_snap_tips_main.xml`, `MyProfileActivity.kt:2659-2676`). On the second Help Hub screen the card's text is written in English in the code (`app/src/main/java/gmail/com/snapfixapp/activity/HelpHubActivity.kt:299-300`).

### Android "QUICK TOUR" dialog

The title "QUICK TOUR", "Let’s take a look at the Snapfix main screen.", a "Start" button and a close button. The back key does not close it. A "Show me later" link is in the layout but hidden, and no code shows it \[[ASK-193](https://github.com/snapfix/docs/blob/main/ASK.md#ask-193-should-androids-snaptips-dialog-offer-show-me-later)] (`app/src/main/res/layout/dialog_new_in_snapfix.xml:41-100`, `app/src/main/java/gmail/com/snapfixapp/dialog/NewInSnapfixDialog.kt:16-44`).

### App tour cards

iOS and Android show the same six cards. Each has a progress bar, a title, a text, a back button (not on the first card), "Next" ("Done" on the last card) and a close button (`SnapFix/SnapTipsView.swift:16-102`, `BusinessListingActivity.java:4640-4760`).

| Card | Points at          | Title            | Text                                                                                                                                                                  |
| ---- | ------------------ | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1    | The profile button | "HELP & PROFILE" | "Edit your profile details, update info, and adjust settings, such as notifications here." and "Looking for guidance? Visit the Help Hub for tips, FAQs and support!" |
| 2    | The first tab      | "SNAP!"          | "Snap a Photo and create a task/workorder in seconds."                                                                                                                |
| 3    | The second tab     | "FIX!"           | "Manage your Tasks using our Feed, Groups and Rooms/Areas."                                                                                                           |
| 4    | The third tab      | "CHAT!"          | "Chat 1:1 and in Groups with your Team."                                                                                                                              |
| 5    | The fourth tab     | "PLAN!"          | "Plan and manage your Planned Tasks, Assets and Compliance."                                                                                                          |
| 6    | The plus button    | "CREATE"         | "Create Tasks and Groups for you and your Team, in seconds."                                                                                                          |

## Inputs

None.

## Actions

**Web**

| Action                   | Who                  | What happens                                                                                                                                                                             | API  |
| ------------------------ | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---- |
| "Take A Quick Tour"      | Every signed-in user | Opens the "NEW!" dialog.                                                                                                                                                                 | None |
| "Explore now!"           | Every signed-in user | Closes the dialog and starts the tour at the first step the user gets (`src/app/components/snaptips/snaptips-dialog/snaptips-dialog.component.ts:30-33`, `snaptips.service.ts:124-135`). | None |
| "Show me later" or close | Every signed-in user | Closes the dialog. Nothing is stored.                                                                                                                                                    | None |
| "NEXT"                   | Every signed-in user | Moves to the next step the user gets.                                                                                                                                                    | None |
| "DONE" or close          | Every signed-in user | Ends the tour. The next start begins at the first step again (`snaptips.service.ts:164-170`).                                                                                            | None |

**iOS and Android**

| Action                            | Who                  | What happens                                                                                                                    | API  |
| --------------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ---- |
| The Snaptips card                 | Every signed-in user | iOS: switches to the Fix tab's group list and shows the start card. Android: opens the group list with the "QUICK TOUR" dialog. | None |
| "Start"                           | Every signed-in user | Starts the six-card tour.                                                                                                       | None |
| Close on the start card or dialog | Every signed-in user | Closes it with no tour. Android also records the tips as shown (`BusinessListingActivity.java:4449-4462`, `:4631-4637`).        | None |
| "Next", back, "Done"              | Every signed-in user | Moves between the cards. "Done" on the last card ends the tour.                                                                 | None |
| Close on a card                   | Every signed-in user | Ends the tour.                                                                                                                  | None |

## States

* **Loading:** none. The tours use no server data; on the web the tour made no request in the live pass.
* **Empty:** none. On the web, steps 2, 3, 4, 7 and 11 always show.
* **Error:** none.
* **No permission:** none. On the web, steps a user cannot use are left out.
* **Offline (mobile):** the tours work offline.

## Dialogs and sheets

### Welcome tour (iOS and Android)

After a new account is made, the apps' group list opens a welcome popup (iOS) or sheet (Android) instead of the Snaptips dialog \[[ASK-194](https://github.com/snapfix/docs/blob/main/ASK.md#ask-194-who-should-get-the-quick-tour-after-signing-up-and-should-the-tours-match)]:

* **iOS** shows it after every registration in the app. It cannot be closed by a tap or a drag. It reads "Welcome !", "Let’s get things done!" and "Take a quick tour to Snapfix to get started.", with "Take a Quick Tour" and "Start Snapfixing" (`SnapFix/PostRegistration/RegistrationType.swift:29-36`, `SnapFix/BusinessListingVC.swift:2859-2870`, `SnapFix/WelcomePopupVC.swift:20-25`, `:31-61`, `:87-93`).
* **Android** shows it while its "invited user" flag is set, and the Android sign-up screen sets that flag for every new account. It reads "Welcome, !", "Let's get things done!" and "Take a quick tour of Snapfix to get started.", with "Take a Quick Tour" and "Start Snapfixing" (`BusinessListingActivity.java:794-811`, `app/src/main/java/gmail/com/snapfixapp/activity/RegistrationNewActivity.java:873-880`, `app/src/main/java/gmail/com/snapfixapp/model/User.java:614-617`, `app/src/main/java/gmail/com/snapfixapp/bottomSheet/WelcomeBottomSheet.kt:61-104`).
* "Take a Quick Tour" starts a two-card tour: "SNAP" and "FIX" on iOS, "SNAP!" and "FIX!" on Android, each with "Next". Both apps log these "Next" taps under the wrong event names. "Start Snapfixing" closes the popup or sheet with no tour.
* After the second card a "Done!" popup or sheet shows "Want to see more?" and "Take a look at our Help Hub for more tours, FAQs, support and more!", with "Start Snapfixing", which closes it, and "Learn More", which opens the [Help Hub](https://docs.snapfix.com/how-the-apps-work/screens/help/help-hub.md): on Android its second copy, `HelpHubActivity` \[[ASK-190](https://github.com/snapfix/docs/blob/main/ASK.md#ask-190-which-android-help-hub-should-stay-my-profiles-tab-or-the-separate-screen)] (`SnapFix/BusinessListingVC+HelpHub.swift:49-97`, `BusinessListingActivity.java:4765-4800`).

### Tips that never show (Android)

Android also has an account-switcher tip, a bottom-bar tip and a method that would open the "QUICK TOUR" dialog by itself. Nothing calls them, so they never show (`BusinessListingActivity.java:663-665`, `:4464-4612`).

## Platform differences

| Topic                | Web                              | iOS                                     | Android                                                                                                                           |
| -------------------- | -------------------------------- | --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| Start                | "NEW!" dialog, then the tour     | Start card, then the tour               | "QUICK TOUR" dialog, then the tour                                                                                                |
| Where the tour runs  | Over the side menu               | Over the Fix tab's group list           | Over the group list                                                                                                               |
| Steps                | Up to ten, by role and site type | Six                                     | Six                                                                                                                               |
| Back button on cards | None                             | Yes, except on the first card           | Yes, except on the first card                                                                                                     |
| "Show me later"      | Closes the dialog                | None                                    | Hidden \[[ASK-193](https://github.com/snapfix/docs/blob/main/ASK.md#ask-193-should-androids-snaptips-dialog-offer-show-me-later)] |
| Opens by itself      | The dialog, after a web sign-up  | The welcome popup, after a registration | The welcome sheet, after a sign-up                                                                                                |
| Snaptips card        | None                             | "Getting Started Quick Tour"            | "GETTING STARTED QUICK TOUR"                                                                                                      |


---

# 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/help/snaptips.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.
