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

# Walkthrough

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

Three intro slides shown once, before sign-in.

* **Where:** iOS and Android: from the [splash screen](https://docs.snapfix.com/how-the-apps-work/screens/account/splash.md) when the walkthrough has not been seen.
  * iOS checks this before the signed-in path, so a signed-in user whose flag is still unset sees it too.
  * Android opens it only from the signed-out splash paths. It also comes back after the app switches between the live and test backends, because that clears every stored preference.
  * On iOS, opening an invitation link marks the walkthrough as seen (ios @ aa31967ac8, `Managers/DeepLink/DynamicLinkContextDeeplinkHandler.swift:193`), so a new user who starts from an invitation does not see the slides.
* **Who:** anyone on that first launch; no role check.
* **Feature:** [App launch](https://docs.snapfix.com/product/features/account/app-launch.md)

## Layout

Top to bottom, on both apps:

1. The Snapfix logo.
2. The open slide: a title, a picture and a caption. Swiping moves between slides. The pictures are stills: iOS has code to load animated versions, but it is commented out.
3. Three page dots (red, amber, green).
4. The main button. Its label follows the slide.
5. "Skip", under the main button. Hidden on the third slide; on Android it is invisible there and still takes its space.

On a wide screen, Android keeps the content in a centred column.

| Slide | Title                             | Caption                                                                                        |
| ----- | --------------------------------- | ---------------------------------------------------------------------------------------------- |
| 1     | "Report & Resolve Issues Quicker" | iOS "It’s as easy as taking a photo!", Android "It's as easy as taking a photo!"               |
| 2     | "Better Team Communication"       | "Get more work done together."                                                                 |
| 3     | "Make Informed Decisions"         | "Track tasks, accountability and team productivity." Android breaks it after "accountability". |

iOS adds a fourth, empty page after the third slide. Landing on it leaves the walkthrough.

## Inputs

None.

## Actions

| Action                    | Who                    | What happens                                                                                                                                                                | API |
| ------------------------- | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- |
| "Next"                    | Anyone, slide 1        | Opens slide 2. The main button becomes "Continue".                                                                                                                          | -   |
| "Continue"                | Anyone, slide 2        | Opens slide 3. The main button becomes "Let’s get started" and "Skip" hides.                                                                                                | -   |
| "Let’s get started"       | Anyone, slide 3        | Leaves the walkthrough ([Where it goes](#where-it-goes)).                                                                                                                   | -   |
| "Skip"                    | Anyone, slides 1 and 2 | Leaves the walkthrough.                                                                                                                                                     | -   |
| Page dot (iOS)            | Anyone                 | Opens that slide; the third dot does not leave.                                                                                                                             | -   |
| Page dot (Android)        | Anyone                 | A dot that is not current opens its slide. The current dot advances: red on slide 1 opens slide 2, amber on slide 2 opens slide 3, green on slide 3 leaves the walkthrough. | -   |
| Swipe past the last slide | Anyone                 | Leaves the walkthrough. On iOS the swipe lands on the empty fourth page first.                                                                                              | -   |
| Back (Android)            | Anyone                 | Leaves the walkthrough rather than going back a slide. iOS has no back: this screen is the window root.                                                                     | -   |

Both apps log `s_firstopen_next`, `s_firstopen_continue`, `s_firstopen_start` and `s_firstopen_skip`. iOS logs them when the buttons are tapped; Android logs the first three whenever that slide becomes the open one.

### Where it goes

**iOS** (`SnapFix/WalkMasterVC.swift:174-183`) sets the walkthrough-seen flag, then opens:

* signed in: [Reloading Snapfix](https://docs.snapfix.com/how-the-apps-work/screens/account/download-data.md), which goes on to Home when nothing is pending;
* anyone else: [Sign in](https://docs.snapfix.com/how-the-apps-work/screens/account/sign-in.md).

**Android** (`WalkthroughActivity.kt:204-234`), with the flag already set when the screen opened:

* signed out: [Sign in](https://docs.snapfix.com/how-the-apps-work/screens/account/sign-in.md); this is the path the splash uses;
* signed in and the account must create a site: the start-or-join flow;
* signed in with a reload or database update pending: on Android 6.0 and later, [Reloading Snapfix](https://docs.snapfix.com/how-the-apps-work/screens/account/download-data.md) only when write-storage permission is already granted. It never asks for it: without it, the app clears its preferences, signs the user out and opens [Sign in](https://docs.snapfix.com/how-the-apps-work/screens/account/sign-in.md). Before Android 6.0 it opens the reload directly;
* otherwise signed in: the sync service starts and the group list opens.

## States

* **Loading:** none; the slides are in the app.
* **Empty:** the fourth iOS page is blank.
* **Error:** no message. The Android storage branch signs the user out without saying why.
* **No permission:** the slides ask for no permission.
* **Offline (mobile):** works offline; the next screen handles its own offline state.

## Platform differences

| Topic                    | iOS                                                                                              | Android                                                                       |
| ------------------------ | ------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------- |
| When it counts as seen   | When the person leaves it, by any way out                                                        | As soon as the screen opens, so leaving the app on a slide skips it next time |
| Pages                    | Three slides and an empty fourth page                                                            | Three slides                                                                  |
| "Skip" on the last slide | Hidden                                                                                           | Invisible, its space kept                                                     |
| Page dots                | Open that slide                                                                                  | The current dot advances, or leaves on the last slide                         |
| Back                     | None                                                                                             | Leaves the walkthrough                                                        |
| Signed in on the way out | [Reloading Snapfix](https://docs.snapfix.com/how-the-apps-work/screens/account/download-data.md) | Start-or-join, reload, group list, or sign-in after the storage check         |


---

# 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/account/walkthrough.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.
