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].
Building a mobile app that connects directly to glasses over Bluetooth? Use the
Bluetooth SDK Quickstart 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
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
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.Or: run it on your computer
Staying up to date
@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
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
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.

