# Quickstart

> Run a complete Glassly Bluetooth SDK example app on a physical phone.

Source: https://docs.dev.glassly.ai/bluetooth-sdk/quickstart/

The fastest way to get started with the Glassly Bluetooth SDK is to run one of
the complete example apps in the
[Glassly Bluetooth SDK Starter Kit](https://github.com/tetramo-labs/glassly-starter-kit).
Choose Android, iOS, or React Native / Expo and connect to Mentra Live without
first adding the SDK to your own app.

- [Open the Starter Kit on GitHub](https://github.com/tetramo-labs/glassly-starter-kit)
Browse the example apps and source code.

Use a physical phone for Bluetooth testing. Simulators and emulators do not
provide the real Bluetooth path.

## 1. Clone the Starter Kit

```bash
git clone https://github.com/tetramo-labs/glassly-starter-kit.git
cd glassly-starter-kit
```

The examples include the OTA flow required to install the Mentra Live glasses
software that matches their Bluetooth SDK version. The React Native example
owns a forkable `src/ota/` presentation layer over Glassly Engine's tested
controller, so you can change its cosmetics without reimplementing OTA
sequencing. For `0.4.2-dev.1184` integration instructions and the
separately published `0.1.21-beta.5` prebuilt example, see [Update
Mentra Live](https://docs.dev.glassly.ai/bluetooth-sdk/software-update.md).

## 2. Run an Example App

### Android

```bash
cd examples/android
./gradlew installDebug
```

The Android example is a Kotlin / Jetpack Compose app. It installs the SDK as
`ai.glassly:bluetooth-sdk`.

### iOS

```bash
cd examples/ios
open GlasslyExample.xcodeproj
```

Choose a physical iPhone as the run destination in Xcode. The iOS example is a
SwiftUI app that installs the `BluetoothSDK` Swift package.

### React Native / Expo

```bash
cd examples/react-native
bun install
bunx expo prebuild
bunx expo run:ios
# or
bun run android:dev
```

The React Native example installs `@glassly/bluetooth-sdk` and demonstrates the
same Device, Camera, Stream, System, and Console flows as the native examples.

## 3. Connect and Explore

Open the example app, scan for Mentra Live, select your glasses, and connect.
The examples demonstrate:

- Connecting, disconnecting, and reconnecting to a saved/default device.
- Checking for and installing the glasses software release that matches the SDK.
- Reading typed glasses and Bluetooth status snapshots.
- Handling button, touch, swipe, head-up, battery, Wi-Fi, hotspot, stream,
  photo, video upload, audio, and SDK log events.
- Controlling gallery mode, capture settings, speaker playback, RGB LEDs,
  Wi-Fi, hotspot, microphone, camera, and streaming.
- Running glasses-to-phone photo and streaming demos.

## Optional Local Media and Streaming Helper

The Camera and Stream screens default to a glasses-to-phone flow. You do not
need a separate server for that default path.

Use the helper only when you turn on **Use cloud server** in the example app and
want to test an external endpoint without deploying your own media upload
webhook or streaming server. From the repository root, run:

```bash
python3 examples/local-demo-cloud/server.py
```

Paste the printed LAN `/upload`, RTMP, SRT, or WHIP URL into the corresponding
example screen. If Docker is unavailable, the helper starts the media upload
webhook and skips streaming with a warning.

Do not use `localhost` in the app. The glasses, phone, and computer must be on a
network where the glasses can reach the printed LAN address.

## Add the SDK to Your App

Ready to integrate the SDK into an existing project? Continue to
[Build from Scratch](https://docs.dev.glassly.ai/bluetooth-sdk/build-from-scratch.md).
