> 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/chat/my-network.md).

# My network

{% 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/chat/my-network.md).
{% endhint %}

What the chat tab shows when chat is off for the site: the user's Snapfix contacts and, with permission, phone contacts, to add people to a group, invite them or message them.

* **Where:** iOS and Android: the bottom-bar chat icon on a site with chat off, in place of [Chats](https://docs.snapfix.com/how-the-apps-work/screens/chat/chats.md). iOS hides the "CHATS" / "MY NETWORK" toggle. There is no web screen; the web sends `/chat/:id` to `/fix`.
* **Who:** any signed-in user on a site with chat off. Nothing here depends on roles; adding someone to a group follows that group's rules.
* **Feature:** [Chat](https://docs.snapfix.com/product/features/chat/chat.md)

With chat on, the tab shows [Chats](https://docs.snapfix.com/how-the-apps-work/screens/chat/chats.md), and the site's users are in [Chat contacts](https://docs.snapfix.com/how-the-apps-work/screens/chat/contacts.md).

## Layout

1. **Android:** the title "My Network". Both apps: a search control (Android hint "Find user"), a contacts control (iOS "Include phone contacts"; Android a contacts-book icon) and an info icon. The info text is: "Invite your friends and colleagues to Snapfix. Create 1:1 Groups, as well as Groups for Teams. Remember you can communicate and collaborate with Snapfix users, all over the world."
2. The list, A to Z by name. Each row shows the picture or initials and the name. The line under it reads "🚥 Hi, I'm using Snapfix" for a Snapfix user; for a phone contact it shows the username or the mobile number with its country code (Android "-/-" when there is neither). Each row has "Add To Group" for a Snapfix user, or "Spread the word" (Android) / "Invite" (iOS) for a phone contact, and a chat button.

The list is the site users stored on the device (not deleted), without you, plus the phone's contacts when allowed. Phone contacts that match a Snapfix user by username or mobile number are dropped. Android's layout also has an "On Call" card, but nothing fills it in, so it never shows.

## Inputs

| Field                                                  | Type   | Required | Default                                                                         | Rules and messages                                                                                                                                                                                                                                                                                                                            |
| ------------------------------------------------------ | ------ | -------- | ------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Search                                                 | Text   | No       | Empty                                                                           | No validation. iOS matches the name, username and mobile number, with the matching letters in bold. Android filters the list as you type.                                                                                                                                                                                                     |
| Include phone contacts (iOS) / contacts icon (Android) | Toggle | No       | iOS: on when contacts access is already allowed; Android: Snapfix contacts only | Asks for contacts access first. iOS shows its contacts-restriction alert when access was refused. Android: "Permission Denied" when refused, and when the system blocks it a dialog says "To easily share messages with your team and contacts, Snapfix to access your contacts. Tap Goto Settings > Permissions, and turn your contacts on." |

## Actions

| Action                       | Who                        | What happens                                                                                                                                                                                                                                | API                                                                      |
| ---------------------------- | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| "Add To Group"               | Anyone, on a Snapfix user  | Opens a group picker ("Add to a group" on iOS), then adds the person to the chosen group ([Add users](https://docs.snapfix.com/how-the-apps-work/screens/groups/add-users.md)).                                                             | [Users API](https://docs.snapfix.com/engineering-reference/api/users.md) |
| "Spread the word" / "Invite" | Anyone, on a phone contact | Opens the system share sheet (Android "Share via") with the invite text and subject from the language file ("Hi, I'm using Snapfix, which is great for managing tasks and getting things done. …").                                         | None                                                                     |
| Chat button                  | Anyone, on a Snapfix user  | Android: opens the direct [conversation](https://docs.snapfix.com/how-the-apps-work/screens/chat/conversation.md), although chat is off for the site. iOS: opens the direct conversation too (`SnapFix/MyNetworkVC+TableView.swift:27-38`). | Firestore                                                                |
| Info icon                    | Anyone                     | Shows the info text above.                                                                                                                                                                                                                  | None                                                                     |

## States

* **Loading:** the list fills from the device's database; Android can show "Please wait..." while phone contacts load.
* **Empty:** an empty list with no text.
* **Error:** see the contacts-access messages in [Inputs](#inputs).
* **No permission:** without contacts access, only Snapfix users are listed. Once access is allowed, the apps also send the contacts to Snapfix.
* **Offline (mobile):** the list reads the device's database, so it shows without a connection; inviting and opening chats need one.

## Platform differences

| Topic                | iOS                             | Android                    |
| -------------------- | ------------------------------- | -------------------------- |
| Phone contacts       | "Include phone contacts" button | contacts-book icon         |
| Phone contact button | "Invite"                        | "Spread the word"          |
| Search matches       | name, username, mobile          | the list filter            |
| Chat button          | opens the direct chat           | opens the direct chat      |
| On Call card         | none                            | in the layout, never shown |


---

# 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/chat/my-network.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.
