Docs

Install on Android

• Download app-release.apk from the Releases page.
• Allow your browser to install unknown apps when prompted.
• Open the APK and install. No account, email, or internet is required.
• Create a local identity on first launch.

Permissions you'll be asked for

• Bluetooth scan and connect — required to discover and reach nearby peers.
• Nearby Wi-Fi devices — used by the discovery boundary on newer Android versions.
• Microphone — optional, only for voice-related actions.
• Notifications — alerts for SOS and incoming relayed messages.

Connect to nearby devices

• Tap New conversation — it opens Nearby devices, not Settings.
• Start a real BLE scan; only discovered peers are listed, with RSSI and distance labels.
• Connect, then pair contacts manually to exchange keys.
• Out-of-range destinations are reached through relay phones or a courier device.

Developer quick start

pnpm install
pnpm dev
pnpm verify:all

• verify:all runs TypeScript, lint, Vitest, Android env checks, Gradle validation, and Rust tests.
• Use a physical Android device for BLE and permission validation.

Base camp server

cd base-laptop
MOCK_AI=1 cargo test
MOCK_AI=1 cargo run

• Rust/Axum server persisting reports, audit entries, and prioritized actions in SQLite.
• Serves a dashboard backed by the live API with honest empty states.