---
title: "Mobile App"
canonical_url: https://developer.repebble.com/mobile-app/
last_updated: 2026-10-11
sdk_version: 4.33.1
---
# Mobile App

Source: https://developer.repebble.com/mobile-app/

The Pebble mobile app is the phone app for Pebble watches and the Index 01 ring. It runs on iOS and Android and is available at [repebble.com/app](https://repebble.com/app). The app is open source at [github.com/coredevices/mobileapp](https://github.com/coredevices/mobileapp), written in Kotlin Multiplatform with one codebase for both platforms. Developers can build their own features and open a pull request to the repository, or maintain their own fork.

For app developers, the mobile app is the other half of a watchapp. It runs the PebbleKit JS part of an app, carries the [_Developer Connection_](https://developer.repebble.com/guides/tools-and-resources/developer-connection.md) that the `pebble` tool uses to install and debug apps on a watch, sideloads `.pbw` files, and talks to the Pebble appstore. For Index 01 it collects recordings from the ring, sends them to [webhooks](https://developer.repebble.com/index-01/webhooks.md), connects to [MCP servers](https://developer.repebble.com/index-01/mcp.md) and runs [_plugins_](https://developer.repebble.com/guides/plugins.md).

## Building the App

The repository [README](https://github.com/coredevices/mobileapp#readme) has the setup steps. On Android the app builds with Gradle from Android Studio and needs a `google-services.json` in `androidApp/src`; a dummy file is provided. On iOS the build needs Java 17, CocoaPods, an Android SDK (several modules use the Android Gradle plugin) and the iOS platform for Xcode, after which `./gradlew podInstall` sets up the dependencies and the app is built from `iosApp/iosApp.xcworkspace` in Xcode. Features such as bug reporting, Google sign-in and online transcription need tokens in `gradle.properties`; the core features work without them.

The app can connect to a PebbleOS emulator over TCP in place of a watch. [_Testing with the Pebble Mobile App_](https://developer.repebble.com/guides/tools-and-resources/testing-with-the-mobile-app.md) covers running the app against the emulator, which is how a change that touches both the firmware and the app is tested.

## Related

- [_PebbleKit JS_](https://developer.repebble.com/guides/communication/using-pebblekit-js.md) has a section on the differences between the PebbleKit JS runtime in the Pebble mobile app and the original one.
- [_Developer Connection_](https://developer.repebble.com/guides/tools-and-resources/developer-connection.md) describes how the `pebble` tool installs apps through the phone.
- [_Plugins (Preview)_](https://developer.repebble.com/guides/plugins.md) describes the `.pbw` packages that run inside the app and extend the Index agent.
- [Index 01 webhooks](https://developer.repebble.com/index-01/webhooks.md) describes the HTTP request the app sends for each recording.
- [Contributing](https://developer.repebble.com/mobile-app/contributing.md) describes how changes get into the repository.