# 📱 OxygenHub Android

![Status: Planning](https://img.shields.io/badge/Status-Planning-blue)
![Platform: Android](https://img.shields.io/badge/Platform-Android-green)
![CI: Flow](https://img.shields.io/badge/CI-Flow-blue)

The official native Android client for OxygenHub, designed for modern devices and fully optimized for foldables like the Pixel 10 Pro Fold. 

Built with **Kotlin**, **Jetpack Compose**, and deep **Rust interop** (via `uniffi-rs`) to execute native `oxy` commands directly on your device.

---

## ✨ Features
* 🧬 **Commutative History:** Native visualization of the change graph.
* 🔀 **Offline-First Conflicts:** Resolve conflicts on the go; they're just data.
* 🌊 **Job Flow Control:** Orchestrate OxygenFlow CI/CD pipelines right from your phone.

## 🛠️ Setup

1. Clone the repository with `oxy clone`, and fetch the pinned Oxygen
   sources: `oxy submodule update --init` (rust-core builds over `oxygen/`).
2. Install the Android SDK with an NDK (Android Studio's SDK manager), and
   point `local.properties` at it (`sdk.dir=…`) or set `ANDROID_HOME`.
3. Install the Rust side: `cargo install cargo-ndk` and
   `rustup target add aarch64-linux-android x86_64-linux-android`.
4. Build and test; the build compiles rust-core for arm64-v8a and x86_64
   and generates its Kotlin bindings itself:
   ```bash
   ./gradlew :app:assembleDebug :app:testDebugUnitTest
   ```

## 🏗️ CI/CD

We dogfood **OxygenFlow** for our builds. 
The pipeline is defined in `.flow/pipeline.kdl`.

---
*If you notice any issues with Flow or Oxygen during development, please log them in the `~/oxygen_feedback.md` document for the core team.*