Start from the scaffolder
The fastest path iscreate-mentra-miniapp. It writes a ready-to-run project
with both layers wired together. The Quickstart
walks through it end to end.
--type choice only changes the manifest’s hardwareRequirements (display
vs. camera plus microphone). The generated code is the same either way: a glasses
button press calls session.display.render(...), and the WebView UI sends a
ping that the background answers with a pong carrying a roundtrip timestamp.
That gives you a button-to-display path and a UI-to-background path to edit from.
The in-repo reference miniapp
If you’ve cloned the monorepo,miniapps/example-miniapp is the reference app
that consumes the SDK. Its manifest names it “Mentra Example”, and it exercises
more of the surface than the starter does: transcription, text-wall display, TTS,
button events, and an “SDK Tester” UI that drives each session module
(session.camera, session.location, notifications, calendar) page by page.
Run it from the repo to see the SDK working against your phone:
bun dev validates the manifest, builds both layers, serves them over your LAN,
and prints a QR code. Scan it from Mentra App → Settings → Developer settings →
Mini App Development → Scan Mini App QR Code (phone and laptop on the same
Wi-Fi).
First-party miniapps in this repo
These are apps Mentra ships, all underminiapps/. Read them when you want a
real feature rather than a demo. Each builds with bun dev the same way the
example does.
Teleprompter
miniapps/teleprompter: paste a script and read it off the glasses;
scrolling follows your voice or runs at a set speed.Mentra Maps
miniapps/navigation: turn-by-turn walking navigation with compass heading
and Google Maps, driven by session.location.Recorder
miniapps/recorder: capture the glasses microphone to a WAV file on your
phone, play it back, and export it. Built on session.recorder +
session.blob.Captions
miniapps/captions: live transcription rendered on the display, with a
WebView for language and display settings.Translation
miniapps/translation: translate a detected source language into a target
language and render it on the display.New here? Read the Quickstart first, then
come back and open whichever app above is closest to what you’re building.

