> ## Documentation Index
> Fetch the complete documentation index at: https://cloud-docs.mentra.glass/llms.txt
> Use this file to discover all available pages before exploring further.

# MentraOS Cloud Documentation

> Internal documentation for MentraOS Cloud development

## Welcome to MentraOS Cloud

This is the internal documentation for developers working on the MentraOS Cloud codebase. Here you'll find detailed information about the cloud architecture, services, managers, and how to set up your development environment.

<Card title="Cloud Architecture Overview" icon="cloud" href="/cloud-overview/introduction" horizontal>
  Understand how the cloud orchestrates communication between glasses, mobile apps, and third-party applications.
</Card>

## Getting Started

Essential resources for cloud development.

<Columns cols={2}>
  <Card title="Local Development Setup" icon="laptop" href="/development/local-setup">
    Run the cloud locally with Docker, ngrok, and connect your mobile app.
  </Card>

  <Card title="Authentication Flow" icon="shield" href="/cloud-overview/authentication-flow">
    Understand JWT authentication and session management.
  </Card>

  <Card title="User Sessions" icon="users" href="/cloud-overview/user-sessions">
    Learn about UserSession - the core entity managing connections.
  </Card>

  <Card title="Message Types" icon="message" href="/cloud-overview/message-types">
    All message types flowing between glasses, cloud, and apps.
  </Card>
</Columns>

## Core Architecture

Deep dive into the cloud's internal structure.

<Columns cols={3}>
  <Card title="WebSocket Service" icon="plug" href="/cloud-architecture/services/websocket-service">
    Routes connections between glasses and apps
  </Card>

  <Card title="Session Service" icon="server" href="/cloud-architecture/services/session-service">
    Orchestrates UserSession lifecycle
  </Card>

  <Card title="UserSession Class" icon="user" href="/cloud-architecture/session-management/user-session-class">
    The heart of the system - manages everything
  </Card>

  <Card title="Managers Pattern" icon="puzzle" href="/cloud-architecture/managers/overview">
    Specialized managers for different concerns
  </Card>

  <Card title="Subscription Service" icon="bell" href="/cloud-architecture/services/subscription-service">
    Controls data flow to apps
  </Card>

  <Card title="Message Types" icon="message" href="/cloud-overview/message-types">
    All SDK types and interfaces
  </Card>
</Columns>

## Manager Documentation

Detailed guides for each UserSession manager.

<Columns cols={2}>
  <Card title="App Manager" icon="cube" href="/cloud-architecture/managers/app-manager">
    App lifecycle, webhooks, and resurrection
  </Card>

  <Card title="Audio Manager" icon="volume" href="/cloud-architecture/managers/audio-manager">
    Audio processing and distribution
  </Card>

  <Card title="Display Manager" icon="monitor" href="/cloud-architecture/managers/display-manager">
    Display throttling and prioritization
  </Card>

  <Card title="Transcription Manager" icon="microphone" href="/cloud-architecture/managers/transcription-manager">
    Multi-provider speech-to-text
  </Card>
</Columns>

## Join the Community

<Columns cols={2}>
  <Card title="Discord" icon="discord" href="https://discord.gg/5ukNvkEAqT">
    Chat with other developers and get help from the team.
  </Card>

  <Card title="GitHub" icon="github" href="https://github.com/Mentra-Community/MentraOS">
    Contribute to MentraOS and see the source code.
  </Card>
</Columns>