# MentraOS

- [Welcome to MentraOS](https://docs.mentraglass.com/index.md): Cloud operating system for smart glasses
- [Contribute to MentraOS](https://docs.mentraglass.com/contributing.md): Find the maintained source, setup instructions, and contribution guidance for each part of MentraOS.
- [Third-Party Licenses](https://docs.mentraglass.com/third-party-licenses.md): Open source components used in MentraOS and the Mentra App
- [Overview](https://docs.mentraglass.com/app-devs/getting-started/overview.md): Build on-device apps for smart glasses with the Mentra Miniapp SDK.
- [Quickstart](https://docs.mentraglass.com/app-devs/getting-started/quickstart.md): Scaffold a Mentra miniapp and run it on your phone in a few minutes.
- [Example miniapps](https://docs.mentraglass.com/app-devs/getting-started/example-apps.md): Working miniapps to start from: the scaffolder starter, the in-repo reference, and first-party apps shipped in this repo.
- [Distribution](https://docs.mentraglass.com/app-devs/getting-started/distribution.md): Prepare and install miniapp builds for local testing.
- [AI IDE Integration](https://docs.mentraglass.com/app-devs/getting-started/ai-ide-integration.md): Connect your AI coding assistant to MentraOS docs for smarter development
- [Two-layer architecture](https://docs.mentraglass.com/app-devs/core-concepts/two-layer-architecture.md): How a miniapp's always-on background and on-demand UI layers work and talk to each other.
- [The manifest (miniapp.json)](https://docs.mentraglass.com/app-devs/core-concepts/miniapp-manifest.md): Declare your miniapp's identity, entry points, permissions, and hardware requirements.
- [The session](https://docs.mentraglass.com/app-devs/core-concepts/session.md): Your background-layer handle to everything on the glasses.
- [Actions](https://docs.mentraglass.com/app-devs/core-concepts/miniapp-interop.md): Expose typed actions from your miniapp so Mentra AI can call them.
- [The UI layer](https://docs.mentraglass.com/app-devs/core-concepts/webviews/react-webviews.md): Build the miniapp's WebView UI with React, talking to the background over the injected mentra global.
- [Safe areas & the capsule menu](https://docs.mentraglass.com/app-devs/core-concepts/webviews/safe-areas.md): Lay out your webview UI around the host chrome: notch insets and the floating capsule menu.
- [Back navigation](https://docs.mentraglass.com/app-devs/core-concepts/webviews/back-navigation.md): Make the phone's back gesture step back through your miniapp's screens and dialogs before it minimizes the miniapp.
- [Display](https://docs.mentraglass.com/app-devs/core-concepts/display/layouts.md): Render scenes of positioned text, images, and shapes on the glasses.
- [LED](https://docs.mentraglass.com/app-devs/core-concepts/led/overview.md): Drive the indicator LED on glasses that have one.
- [Transcription](https://docs.mentraglass.com/app-devs/core-concepts/microphone/speech-to-text.md): Real-time speech-to-text from the glasses microphone.
- [Translation](https://docs.mentraglass.com/app-devs/core-concepts/translation.md): Real-time translation of speech from the glasses microphone.
- [Microphone](https://docs.mentraglass.com/app-devs/core-concepts/microphone/audio-chunks.md): Raw audio frames and voice-activity detection from the glasses mic.
- [Speaker](https://docs.mentraglass.com/app-devs/core-concepts/speakers/text-to-speech.md): Play URLs, text-to-speech, and live PCM audio through the phone or connected glasses.
- [Input](https://docs.mentraglass.com/app-devs/core-concepts/input.md): Glasses button presses and touchpad gestures.
- [Glasses](https://docs.mentraglass.com/app-devs/core-concepts/glasses.md): Battery level and connection state of the glasses.
- [Location](https://docs.mentraglass.com/app-devs/core-concepts/location.md): The user's GPS position, as a one-shot fix or a continuous stream.
- [Heading](https://docs.mentraglass.com/app-devs/core-concepts/heading.md): The phone's compass heading, as a continuous stream of degrees.
- [IMU](https://docs.mentraglass.com/app-devs/core-concepts/imu.md): Head-position events from the glasses inertial measurement unit.
- [Navigation](https://docs.mentraglass.com/app-devs/core-concepts/navigation.md): Turn-by-turn directions on the glasses, driven by the phone's GPS.
- [Photos](https://docs.mentraglass.com/app-devs/core-concepts/camera/photos.md): Capture photos on camera glasses.
- [Videos](https://docs.mentraglass.com/app-devs/core-concepts/camera/videos.md): Record video on camera glasses.
- [Streaming](https://docs.mentraglass.com/app-devs/core-concepts/stream.md): Live video streaming from camera glasses.
- [Stream preview](https://docs.mentraglass.com/app-devs/core-concepts/stream-preview.md): Show the live video of a call inside your miniapp's UI.
- [Phone](https://docs.mentraglass.com/app-devs/core-concepts/phone.md): Phone Wi-Fi, notifications, calendar events, and battery.
- [System](https://docs.mentraglass.com/app-devs/core-concepts/system.md): Phone-side OS actions: share sheet, downloads, clipboard, open URL.
- [Permissions](https://docs.mentraglass.com/app-devs/core-concepts/permissions.md): Query the permissions your miniapp declared, and react to changes.
- [Storage](https://docs.mentraglass.com/app-devs/core-concepts/storage.md): Persistent key-value storage scoped to your miniapp.
- [Blob](https://docs.mentraglass.com/app-devs/core-concepts/blob.md): Persistent binary storage for files, images, and audio.
- [Auth](https://docs.mentraglass.com/app-devs/core-concepts/auth.md): Call your miniapp's backend as the signed-in Mentra user.
- [Cloud status](https://docs.mentraglass.com/app-devs/core-concepts/cloud.md): Read whether the phone is connected to MentraOS cloud.
- [CLI reference (mentra-miniapp)](https://docs.mentraglass.com/app-devs/reference/cli.md): The author CLI for developing, packing, and releasing Mentra miniapps.
- [System Miniapp APIs](https://docs.mentraglass.com/app-devs/reference/system-apis.md): APIs restricted to system miniapps for interop and privileged device controls.
- [Mentra Bluetooth SDK](https://docs.mentraglass.com/bluetooth-sdk/overview.md): Connect mobile and native macOS apps directly to Mentra Live over Bluetooth.
- [Quickstart](https://docs.mentraglass.com/bluetooth-sdk/quickstart.md): Run a complete Mentra Bluetooth SDK example app on a physical phone.
- [Build from Scratch](https://docs.mentraglass.com/bluetooth-sdk/build-from-scratch.md): Add the Mentra Bluetooth SDK to your own mobile app.
- [Update Mentra Live](https://docs.mentraglass.com/bluetooth-sdk/software-update.md): Install the Mentra Live glasses software that matches your Bluetooth SDK release.
- [AI IDE Integration](https://docs.mentraglass.com/bluetooth-sdk/ai-ide-integration.md): Connect your AI coding assistant to MentraOS docs for smarter development
- [React Native / Expo](https://docs.mentraglass.com/bluetooth-sdk/react-native-expo.md): Use @mentra/bluetooth-sdk from a React Native or Expo development build.
- [Android](https://docs.mentraglass.com/bluetooth-sdk/android.md): Use the Mentra Bluetooth SDK from a native Android app.
- [iOS](https://docs.mentraglass.com/bluetooth-sdk/ios.md): Use the Mentra Bluetooth SDK from a native iOS app.
- [macOS](https://docs.mentraglass.com/bluetooth-sdk/macos.md): Use the Bluetooth SDK in native AppKit, SwiftUI, or react-native-macos apps.
- [API Reference](https://docs.mentraglass.com/bluetooth-sdk/api-reference.md): Lifecycle, status, commands, events, and shared types for the Mentra Bluetooth SDK.
- [Audio](https://docs.mentraglass.com/bluetooth-sdk/audio.md): Use microphone input and route normal phone audio playback to supported glasses speakers.
- [Camera And Streaming](https://docs.mentraglass.com/bluetooth-sdk/camera-streaming.md): Request photos, record videos, and start RTMP, SRT, or WebRTC streams from supported smart glasses.
- [Hardware Integration](https://docs.mentraglass.com/bluetooth-sdk/hardware.md): Handle Mentra Live capabilities and status-driven hardware behavior.
- [Troubleshooting](https://docs.mentraglass.com/bluetooth-sdk/troubleshooting.md): Fix dependency, permission, scan, stream, and React Native build issues.
- [Production Checklist](https://docs.mentraglass.com/bluetooth-sdk/production-checklist.md): Validate a mobile app before shipping with the Mentra Bluetooth SDK.
- [OEM Integration Overview](https://docs.mentraglass.com/glasses-oems/overview.md): Embed the full MentraOS experience (miniapps, the Mentra Miniapp Store, and the developer ecosystem) inside your own phone app, driving your own smart glasses.
- [Mentra OEM Integration Engine API](https://docs.mentraglass.com/glasses-oems/engine.md): The engine.* API an OEM host calls to drive MentraOS on its glasses — connection, pairing, device + user settings, wifi, speech, display, cloud session, miniapps, permissions, notifications, and reports, over a device-agnostic runtime.
- [OEM Firmware Integration Specification](https://docs.mentraglass.com/glasses-oems/firmware-spec.md): Implement the BLE, display, input, audio, notification, and device contracts required for MentraOS-compatible smart glasses.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.