Glassly Miniapp SDK betaThe SDK is in beta, so its APIs may change before general availability.Developing on Mentra Live? We recommend using the Glassly Bluetooth SDK.The developer tools are available in the Glassly App under Settings → Miniapp Developer Settings.Share feedback with an in-app bug report, on Discord, or by email at [email protected].
This Quickstart goes from zero to a miniapp running on your glasses. You need a phone, Bun, and basic TypeScript. You can do the whole thing without glasses: the display just won’t have anywhere to draw. To see the display without glasses, run the project in the Simulator.
Building a mobile app that connects directly to glasses over Bluetooth? Use the Bluetooth SDK Quickstart instead.
No phone or glasses at hand? After Step 2, run glassly sim to use the Simulator on your computer instead.

Step 1: Install the Glassly App

Install the Glassly App on your Android or iPhone from glassly.ai/OS, sign in, and connect your glasses (if you have them).

Step 2: Install the CLI and scaffold a project

The scaffolder asks for a project name and your package prefix (the reverse-DNS prefix on your developer org in the Developer Console, like com.example), then generates a ready-to-run two-layer project: a small live-captions miniapp.
bun install pulls in @glassly/miniapp (the runtime) and a project copy of @glassly/cli. Inside the project, the global glassly command runs that copy, so every project uses the tooling version its package.json pins.

Step 3: Start the dev server

This validates your miniapp.json, builds both layers, serves them over your LAN, and prints a QR code plus a miniapp://dev?... URL. It hot-reloads on save and forwards the miniapp’s console logs back to your terminal.

Step 4: Load it on your phone

In the Glassly App, go to Settings → Miniapp Developer Settings → Scan Miniapp QR Code and scan the QR from your terminal.
Your phone can be on any network. The QR carries an iroh ticket, so the Glassly App reaches your laptop directly or through a relay, and a saved dev miniapp reconnects after you restart glassly dev. Older Glassly App builds only use the LAN address in the QR, so they need the same Wi-Fi network.
The miniapp installs and starts. Speak and your words appear on the glasses and on the miniapp’s phone page. On the glasses, tap to pause, swipe to scroll back through earlier lines, and hold to hear the shown line read aloud.

Or: run it on your computer

This opens the Simulator: the glasses display, controls for the touch bar and head gestures, and the phone page side by side. Type a sentence under Speech heard by the glasses and press Say: it appears as a caption on the simulated display and the phone page. It reloads on save too, so you can build most of a miniapp here and check it on glasses before you ship.

Staying up to date

This moves the project’s @glassly/miniapp, @glassly/cli, and @glassly/miniapp-cli to the newest release on the channel the project already uses, runs bun install, and upgrades the global glassly too. The CLI checks npm once a day and prints a notice when something is behind. Set GLASSLY_NO_UPDATE_CHECK=1 to turn the check off. It is already off in CI.

Understanding the starter

The background owns the session. It subscribes to speech and gestures, keeps the history in storage, and redraws the glasses:
src/background/index.ts
display.render() takes the whole frame each time. Elements with stable ids update in place, and a transition animates the change on glasses that can:
src/background/scene.ts
The phone page is a normal React app that talks to the background through the typed channels in src/shared/channels.ts. It has no direct hardware access:
src/ui/App.tsx

Next steps

Two-layer architecture

How background and UI work and communicate.

The session

Every capability you can reach on the glasses.

The manifest

Permissions, hardware requirements, and entry points.

Ship it

Pack a release and put it in front of users.

Simulator

Run and script a miniapp with no phone or glasses.

AI IDE integration

Let a coding agent build, run, and check your miniapp.