# mob v0.6.12 - Table of Contents

BEAM-on-device mobile framework for Elixir

## Pages

- [Mob](readme.md)
- [Changelog](changelog.md)

- Guides
  - [Why the BEAM?](why_beam.md)
  - [Getting Started](getting_started.md)
  - [Architecture &amp; Prior Art](architecture.md)
  - [Screen Lifecycle](screen_lifecycle.md)
  - [Components](components.md)
  - [Styling &amp; Native Rendering](styling.md)
  - [Theming](theming.md)
  - [Navigation](navigation.md)
  - [Device Capabilities](device_capabilities.md)
  - [Mobile Surface Matrix](mobile_surface_matrix.md)
  - [Permissions](permissions.md)
  - [Native Extensions (NIFs, features)](native_extensions.md)
  - [DNS on iOS](dns_on_ios.md)
  - [Push Notifications](push_notifications.md)
  - [Data &amp; Persistence](data.md)
  - [Testing](testing.md)
  - [Tooling &amp; Formatting](tooling.md)
  - [Publishing to App Store / TestFlight](publishing.md)
  - [Troubleshooting](troubleshooting.md)
  - [Agentic Coding](agentic_coding.md)

## Modules

- [Mob.Alert](Mob.Alert.md): Native alert dialogs, action sheets, and toast messages.
- [Mob.Background](Mob.Background.md): Background execution keep-alive via a silent audio session.
- [Mob.Bt](Mob.Bt.md): Bluetooth Classic (BR/EDR) — device-level discovery, pairing, and
cross-profile session management.
- [Mob.Bt.Hfp](Mob.Bt.Hfp.md): Bluetooth Classic Hands-Free Profile (HFP) — audio + vendor AT commands.
- [Mob.Bt.Hid](Mob.Bt.Hid.md): Bluetooth Classic Human Interface Device (HID) — input listener.
- [Mob.Bt.Spp](Mob.Bt.Spp.md): Bluetooth Classic Serial Port Profile (SPP) — RFCOMM byte streams.
- [Mob.Canvas](Mob.Canvas.md): Drawing-op constructors for `Mob.UI.canvas/1`.
- [Mob.Component](Mob.Component.md): Behaviour for native view components.
- [Mob.DNS](Mob.DNS.md): Hostname → IP resolution that works around BEAM's broken DNS path
on iOS.
- [Mob.Device](Mob.Device.md): Cross-platform device events and queries.
- [Mob.Device.Android](Mob.Device.Android.md): Android-specific device events. Symmetrical with `Mob.Device.IOS`.
- [Mob.Device.IOS](Mob.Device.IOS.md): iOS-specific device events. Subscribers receive events that either have no
Android counterpart (e.g. `:protected_data_did_become_available`) or carry
extra iOS fidelity beyond what `Mob.Device` exposes cross-platform.
- [Mob.Diag](Mob.Diag.md): Runtime diagnostics that run inside a Mob app's BEAM. Designed to be
invoked via Erlang RPC from a developer's machine to inspect the
actual state of a deployed app.
- [Mob.Event](Mob.Event.md): The unified event emission API for Mob.
- [Mob.Event.Address](Mob.Event.Address.md): Canonical address for an event in the Mob view tree.
- [Mob.Event.Bridge](Mob.Event.Bridge.md): Translates legacy event shapes (`{:tap, tag}`, `{:change, tag, value}`,
`{:tap, {:list, id, :select, index}}`) into the canonical
`{:mob_event, %Address{}, event, payload}` envelope.
- [Mob.Event.Component](Mob.Event.Component.md): Behaviour for **stateful** event-owning components.
- [Mob.Event.Target](Mob.Event.Target.md): Resolves a `target:` spec to a concrete delivery pid.
- [Mob.Event.Throttle](Mob.Event.Throttle.md): Throttle / debounce config for high-frequency event subscriptions.
- [Mob.Event.Trace](Mob.Event.Trace.md): Live tracing of Mob events for IEx debugging.
- [Mob.LiveView](Mob.LiveView.md): Bridge between Phoenix LiveView and the Mob native WebView.
- [Mob.Registry](Mob.Registry.md): Maps component names (atoms) to their platform-specific NIF constructors.
- [Mob.Storage](Mob.Storage.md): App-local file storage.
- [Mob.Storage.Android](Mob.Storage.Android.md): Android-specific storage locations and MediaStore integration.
- [Mob.Storage.Apple](Mob.Storage.Apple.md): iOS-specific storage locations and media library integration.
- [Mob.Theme.Adaptive](Mob.Theme.Adaptive.md): Theme that follows the OS-level light / dark setting.
- [Mob.Theme.AdaptiveWatcher](Mob.Theme.AdaptiveWatcher.md): GenServer that re-resolves the active theme when the OS appearance flips.
- [Mob.Theme.Dark](Mob.Theme.Dark.md): High-contrast greyscale dark theme.
- [Mob.Theme.Light](Mob.Theme.Light.md): High-contrast greyscale light theme.
- [Mob.Theme.ObsidianGlass](Mob.Theme.ObsidianGlass.md): Obsidian + Liquid Glass — the Obsidian palette with `glass: true`, so every
card / sheet renders as a translucent material instead of a solid fill.
- [Mob.VendorUsb](Mob.VendorUsb.md): Raw USB host access via vendor bulk endpoints. **Android only.**
- [Mob.WebView](Mob.WebView.md): Bidirectional JS bridge for the native WebView component.

- Core
  - [Mob](Mob.md): Mob — BEAM-on-device mobile framework for Elixir.
  - [Mob.App](Mob.App.md): Behaviour for Mob application entry point.
  - [Mob.Screen](Mob.Screen.md): Behaviour and GenServer wrapper for a Mob screen.
  - [Mob.ScreenState](Mob.ScreenState.md): Persistent store for screen assigns.
  - [Mob.Socket](Mob.Socket.md): The socket struct passed through all Mob.Screen and Mob.Component callbacks.
  - [Mob.State](Mob.State.md): Persistent key-value store for app state.

- UI
  - [Mob.Renderer](Mob.Renderer.md): Serializes a component tree to JSON and passes it to the platform NIF in
a single call. Compose (Android) and SwiftUI (iOS) handle diffing and
rendering internally.
  - [Mob.Style](Mob.Style.md): Thin wrapper around a props map for named, reusable styles.
  - [Mob.Theme](Mob.Theme.md): Design token system for Mob apps.
  - [Mob.Theme.Birch](Mob.Theme.Birch.md): Birch theme for Mob — warm parchment surfaces with a chestnut-brown accent.
  - [Mob.Theme.Citrus](Mob.Theme.Citrus.md): Citrus theme for Mob — warm charcoal with a lime-green accent.
  - [Mob.Theme.Obsidian](Mob.Theme.Obsidian.md): Obsidian theme for Mob — deep blacks with a violet accent.
  - [Mob.UI](Mob.UI.md): UI component constructors for the Mob framework.

- Navigation
  - [Mob.Nav.Registry](Mob.Nav.Registry.md): ETS-backed registry mapping screen name atoms to their modules.

- Device APIs
  - [Mob.Audio](Mob.Audio.md): Microphone recording and audio playback.
  - [Mob.Biometric](Mob.Biometric.md): Biometric authentication (Face ID / Touch ID / fingerprint).
  - [Mob.Camera](Mob.Camera.md): Native camera capture for photos and videos.
  - [Mob.Clipboard](Mob.Clipboard.md): System clipboard access. No permission required.
  - [Mob.Files](Mob.Files.md): System file picker. Opens the OS document picker (Files app on iOS, SAF on Android).
  - [Mob.Haptic](Mob.Haptic.md): Haptic feedback. No permission required on either platform.
  - [Mob.Location](Mob.Location.md): Device location (GPS / network).
  - [Mob.Motion](Mob.Motion.md): Accelerometer and gyroscope sensor data.
  - [Mob.Notify](Mob.Notify.md): Local and push notifications.
  - [Mob.Permissions](Mob.Permissions.md): Request OS-level permissions from the user.
  - [Mob.Photos](Mob.Photos.md): Photo / video library picker.
  - [Mob.Scanner](Mob.Scanner.md): QR code and barcode scanner.
  - [Mob.Share](Mob.Share.md): System share sheet. Opens the OS share dialog with a piece of content.
Fire-and-forget — no response arrives in the BEAM.

- Testing &amp; Debugging
  - [Mob.Test](Mob.Test.md): Remote inspection and interaction helpers for connected Mob apps.

- Tooling
  - [Mob.Formatter](Mob.Formatter.md): `mix format` plugin for the `~MOB` sigil.

- Internals
  - [Mob.Dist](Mob.Dist.md): Platform-aware Erlang distribution startup.
  - [Mob.List](Mob.List.md): Data-driven list component.
  - [Mob.NativeLogger](Mob.NativeLogger.md): OTP logger handler that routes Elixir Logger output to the platform's native
system log.
  - [Mob.Sigil](Mob.Sigil.md): The `~MOB` sigil for declarative native UI.

## Mix Tasks

- [mix erlfmt](Mix.Tasks.Erlfmt.md): Format `.erl` files (or check formatting with `--check`).
- [mix mob.onboarding_test](Mix.Tasks.Mob.OnboardingTest.md): Runs the Mob onboarding integration tests, which verify that a new user can
go from zero to a running app without hitting any friction that should have
been caught automatically.

