# The RivetMSP Android app

**RivetMSP Mobile** is a native Android app for technicians in the field, built with Kotlin, Jetpack Compose and Material 3. It talks to your own RivetMSP server over the REST API and shows your MSP's name and logo.

## What you can do

- A **dashboard** with open ticket counts, recent activity and alerts.
- Work **tickets**: view, reply, change status, assign technicians and add time charges.
- Browse **assets** and **scan a barcode or QR code** to find one instantly.
- Browse **clients** with their contacts, locations, credentials and contracts.
- View and fill in **worksheets**.
- Search across tickets, clients and assets.
- See and manage **appointments**.
- Get **push notifications** for new tickets and assignments.

## Requirements

- A RivetMSP server on **version 2.4.12 or later**.
- The **REST API enabled** on the server.
- A technician account. Sign in with a password, or with a passkey if you have one set up.

## Set it up

1. Get the app from the [releases page](https://github.com/TheTractorHacker/rivetmsp-mobile/releases). The `release` branch holds stable builds and `beta` has new features first.
2. Open the app and enter your **server address** on first launch.
3. Sign in with your technician credentials.

To switch servers later, use **Change server** on the sign-in screen.

## Your branding

The app picks up your company name and logo. It asks the server for them using `GET /api/v1/branding`, which returns only the public company name and logo path. Upload your logo in the admin area and the app follows.

## Push notifications

Push uses Firebase Cloud Messaging. If you build the app yourself, add your own `google-services.json` to the `app/` folder before building.

## For developers

The app uses the same REST API you can use. See the [REST API guide](/docs/msp/api) and the [API reference](/api/msp) for every endpoint it relies on.

## More

The source is on [GitHub](https://github.com/TheTractorHacker/rivetmsp-mobile), and the app overview, with screenshots, is on the [mobile apps page](/mobile). RivetMSP Mobile is not the official ITFlow app and is not affiliated with ITFlow LLC.
