โ† Back to User Guide
๐Ÿ‘ฅ

Teams

Create or join a team to start sharing your location with colleagues. The Teams screen shows every device, their status, and real-time distance from you.

How Teams Work

Xopoz treats each device as an independent tracking entity. If a person has two phones, both appear as separate entries in your team roster โ€” each with its own position, status and distance.

By default, your location is kept entirely on your device and never shared. You must explicitly create or join a team to enable sharing. You can leave a team at any time to stop sharing.

End-to-end encrypted. Location data is encrypted on your device before it is sent to the server. The server stores only encrypted data and cannot read your coordinates.
Full-trust model. Xopoz operates on a full-trust principle within each team. Every member can see the real-time and historical location of every other member โ€” there is no way to hide your position from specific team members or to exclude individual members from viewing others. If someone should not see another person's location, they must not be in the same team.

Team Roster

The Teams tab shows all members of your teams with a card for each device, including:

Tap any card to jump to that device's location on the map.

Member Roles

Role Capabilities
Creator Full admin rights. Cannot be removed from the team. Generates invite tickets.
Admin Can manage members and team settings. Can generate invite tickets.
Member Standard participation โ€” shares location and sees other members.

Creating a Team

  1. Go to the Teams tab and tap Create Team.
  2. Enter a team name.
  3. Accept the privacy agreement checkbox โ€” this records your consent to share your position with team members.
  4. Tap Create. Your device is automatically added to the team.
  5. The app generates an encryption key for your team and stores it securely on your device. A challenge is sent to the server to prove key ownership โ€” the server never receives the actual key.

Inviting Another Device

To add a new device to your team, you share a Group Ticket.

Step 1 โ€” Generate the Ticket (existing member)

  1. Open the Teams tab and select your team.
  2. Tap Add Device in the team header.
  3. The app retrieves your team's encryption key and generates a ticket in the format [XPZ-teamId-key].
  4. The ticket is copied to your clipboard automatically. You can also share it via the Share button.
  5. Send the ticket to the new user via any channel โ€” SMS, email, messaging app, etc.

Step 2 โ€” Join with the Ticket (new device)

  1. Open Xopoz on the new device and go to the Teams tab.
  2. Tap Join Existing Team.
  3. Accept the privacy agreement checkbox.
  4. Paste or type the Group Ticket into the ticket field.
  5. Tap Join. The app validates the ticket, stores the encryption key securely, and completes team membership.
Secure by design. The ticket contains the team encryption key. The joining device proves it has the key via a cryptographic challenge โ€” the server verifies access without ever seeing the key itself.
Keep your Group Ticket secret. The team encryption key is static for the lifetime of the team and is embedded in the Group Ticket. Anyone with a valid Group Ticket can join the team and access all members' locations. Share it only with people you trust.

Controlling What You See on the Map

Each team and each device has an independent visibility checkbox in the Teams tab.

๐Ÿ‘๏ธ If a team member's device keeps cluttering your map view, you can hide it without affecting anyone else's experience.

Live Updates

Team member data refreshes automatically. The system uses 30-second caching to balance freshness with battery performance. Connection status for each member is shown in real time, so you always know who is actively sharing their location.

Push position warning. If you have disabled Push Location in Settings, a red banner will appear at the top of the Teams tab reminding you that your team will not receive your position.