Home

Zelara Mobile App Wiki

Welcome to the technical documentation for Zelara's mobile application.

Getting Started

For Developers

• Development Setup Guide - Complete guide for running and debugging the app

  • VS Code workflow
  • Android Studio workflow
  • Metro bundler explained
  • Troubleshooting common issues

• Android Studio Build Setup - Build configuration and automation

  • Initial build setup and prerequisites
  • Automating Metro bundler in Android Studio
  • Build configuration details (Gradle, Kotlin)
  • Troubleshooting build errors

Prerequisites & Configuration

• Permissions Setup - Camera and storage permissions configuration

Architecture

Tech Stack

• Framework: React Native 0.76.6 (New Architecture)
• Language: TypeScript
• JS Engine: Hermes
• Navigation: React Navigation (Native Stack)
• State Management: React Context + @zelara packages
• Storage: AsyncStorage (local-first)
• BLE Scanning: react-native-ble-plx — background scan for Zelara Desktop BLE advertisements

Key Services (src/services/)

Service	Purpose
DeviceLinkingService.ts	WebSocket client, TLS, reconnect with backoff, handshake
BLEDiscoveryService.ts	BLE scan for Zelara Desktop; auto-connects via WSS on discovery
ProgressService.ts	AsyncStorage points/unlock persistence

Build Configuration

• Min SDK: Android 7.0 (API 24)
• Target SDK: Android 14 (API 34)
• Compile SDK: Android 15 (API 35)
• JDK: Java 17
• Kotlin: 2.0.21
• Gradle: 8.10.2

Quick Links

• Main README - Project overview and quick start
• Back to Core Repo - Zelara core repository

---

Core Wiki Reference

The main technical documentation lives in the Zelara Core Wiki. Key pages relevant to the mobile app:

• Device Linking Architecture — Protocol design, QR pairing spec, task offloading
• Device Linking — Production Testing — v0.1.2-test through v0.5.0-test: production bugs found & fixed (multi-IP QR, IP fallback, TLS, BLE auto-discovery)
• Architecture — System-wide design decisions
• Technology Stack — Framework and language decisions