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

# Onboarding screens

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

Setting up a new site: the setup form new customers get from the Snapfix team (web\_onboarding\_form), and the setup steps in the mobile apps for people who have no site yet. The screens for accepting an invitation are in [account](https://docs.snapfix.com/how-the-apps-work/screens/account.md).

The two paths create a site differently. The setup form sends one request to api\_php\_live\_v2, which queues the `Onboarding` job ([Create your Snapfix account](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/setup-form.md)). The mobile apps end with a php-apis call made on [Configuring Snapfix](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/configuring.md).

| Screen                                                                                                              | Platforms    | Where                                                                                                    |
| ------------------------------------------------------------------------------------------------------------------- | ------------ | -------------------------------------------------------------------------------------------------------- |
| [Create your Snapfix account](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/setup-form.md)          | web          | web: setup.snapfix.com `/:id`, a link from the Snapfix team                                              |
| [Pre-registration survey](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/pre-registration-survey.md) | ios, android | Android: the sign-in screen, until the survey has been shown. iOS: not reached today                     |
| [Start or join](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/start-or-join.md)                     | ios, android | iOS and Android: after sign-in, sign-up or launch, for an account flagged to create a site; setup step 1 |
| [Company and role](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/company-and-role.md)               | ios, android | iOS and Android: setup step 2                                                                            |
| [Work types](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/work-types.md)                           | ios, android | iOS and Android: setup step 3, only when starting a company                                              |
| [Let us help you](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/let-us-help.md)                     | ios, android | iOS and Android: setup step 4, only after "I don’t know yet" on work types                               |
| [Grid or list](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/grid-or-list.md)                       | ios, android | iOS and Android: setup step 5, the last                                                                  |
| [Configuring Snapfix](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/configuring.md)                 | ios, android | iOS and Android: after the last setup step                                                               |
| [First task group](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/first-task.md)                     | ios, android | iOS: "Start a task" after a setup that started a company. Android: not reachable                         |

Joining an existing company goes from [Start or join](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/start-or-join.md) to [Company and role](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/company-and-role.md) and straight on to [Grid or list](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/grid-or-list.md). The API behind these screens is in [Onboarding API](https://docs.snapfix.com/engineering-reference/api/onboarding.md).


---

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