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

# First task group

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

Choose which group the first task after setup goes into.

* **Where:** iOS: after a setup that started a company, Home shows the "Your Snapfix account is now ready for you." popup ([Configuring Snapfix](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/configuring.md#after-success)); its "Start a task" opens the camera, and after the photo or the text this screen opens. Nothing else opens it. Android: the screen exists (`NewSelectGroupActivity`) but never opens \[[ASK-39](https://github.com/snapfix/docs/blob/main/ASK.md#ask-39-is-the-apps-setup-flow-retired)].
* **Who:** people who have just set up a site by starting a company. The setup flow itself is not reached in the current apps ([Start or join](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/start-or-join.md)), so neither app shows this screen today.
* **Feature:** [Site setup in the app](https://docs.snapfix.com/product/features/onboarding/site-setup.md), [Creating tasks](https://docs.snapfix.com/product/features/tasks/task-creation.md)

Setup does not create a task by itself. The first task is one the person makes from the popup; skipping or closing the popup ends the setup with no task.

## Layout

1. A back arrow at the top left.
2. "Select the group this task goes into" over "Pick one of the groups you have started."
3. The groups on the phone, sorted by name, one row each with the group's image and name and a tick when picked. When there is more than one group, the group named exactly "Learn how to use Snapfix" is left out.
4. "Add to group", disabled until a group is picked.

## Inputs

| Field | Type            | Required | Default | Rules and messages                                                                     |
| ----- | --------------- | -------- | ------- | -------------------------------------------------------------------------------------- |
| Group | One of the list | Yes      | None    | Picking a row clears the other pick. "Add to group" is enabled once a group is picked. |

## Actions

| Action         | Who                  | What happens                                                                                                                                                                                                                                                                                                                                                                                                                                                | API                                                                                                                            |
| -------------- | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| Pick a group   | Anyone on the screen | Ticks it and enables "Add to group".                                                                                                                                                                                                                                                                                                                                                                                                                        | None                                                                                                                           |
| "Add to group" | Anyone, with a pick  | When the user is not an admin of the group and lacks "create task" (`perJobCreateNew`), an alert says "You don’t have the right permissions to create task in this group.\nReach out to the group admin to review your permissions." with "Ok", and the screen stays ("task" reads "asset" in asset registers). Otherwise creates the task from the photo or text in that group on the phone, makes it the current group, and opens Home with the new task. | None on this screen; the task syncs later ([Creating tasks](https://docs.snapfix.com/product/features/tasks/task-creation.md)) |
| Back arrow     | Anyone               | Returns to the photo or text step.                                                                                                                                                                                                                                                                                                                                                                                                                          | None                                                                                                                           |

## States

* **Loading:** none. The groups come from the phone's database.
* **Empty:** with no groups the list is empty and "Add to group" stays disabled.
* **Error:** only the permission alert.
* **No permission:** see "Add to group".
* **Offline (mobile):** works; the task is saved on the phone and sent later.

## Dialogs and sheets

### Congratulations

After "Add to group", the task chat shows "Congratulations!" and "You have created your first Snapfix task.", with "Close Message" and a close cross. It shows once: the post-setup state is cleared as it opens.

## Platform differences

Android has the same screen in code: the same title and subtitle, the groups the user belongs to (leaving out "Learn how to use Snapfix", ignoring case, when there are others), an "Add To Group" button that stays enabled and toasts "Please select atleast one group" when nothing is picked, and the task checks of [Add task to a group](https://docs.snapfix.com/how-the-apps-work/screens/tasks/pick-group.md). It opens only when the preference `isFirstTask` is true, and no code sets it to true; the code only sets it to false, and two of those writes in `FirstTaskCompleteBottomSheet` are never saved because they lack `apply()` \[[ASK-39](https://github.com/snapfix/docs/blob/main/ASK.md#ask-39-is-the-apps-setup-flow-retired)]. So after setup Android opens the group list with no prompt ([Configuring Snapfix](https://docs.snapfix.com/how-the-apps-work/screens/onboarding/configuring.md#after-success)), and the first task goes through the ordinary [Add task to a group](https://docs.snapfix.com/how-the-apps-work/screens/tasks/pick-group.md) screen. Android's "Congratulations!" sheet ("You have created\n your first Snapfix task.") opens on the task screen only when a task comes from this unreachable picker, which marks every task it creates as the first.

The button reads "Add to group" on iOS and "Add To Group" on Android.

An iOS invited-user popup ("Welcome to Snapfix", `InvitedAccountPopupVC`) sits in the same storyboard, but nothing opens it \[[ASK-39](https://github.com/snapfix/docs/blob/main/ASK.md#ask-39-is-the-apps-setup-flow-retired)].


---

# 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/first-task.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.
