Legolas

Legolas is the Android client for Arwen. It scans the QR code printed by Arwen, validates the legolas://pair URI, encrypts the shared API key with Android Keystore, and stores the pairing with DataStore.

Architecture

UI (Compose + ViewModel)
        ↓
PairingRepository
        ↓
DataStore + Android Keystore

Pairing is required for the app to connect to Arwen. Optional feature modules are opt-in: none are included or enabled by default.

Design

See Legolas Design System. It records the shared Root colors, typography, shapes, components, source-of-truth projects, and implementation rules.

Run

1. Start Arwen and keep its terminal QR code visible.
2. Open Legolas on an Android device with Google Play services.
3. Tap Scan QR code and scan the Arwen QR.

The Google Code Scanner handles camera access without adding a camera permission to Legolas. Use Forget Arwen to remove the locally stored connection.

Build

./gradlew test lintDebug assembleDebug