CONVERSION-PLAN.md

Conversion Plan — Port Google AI Edge Gallery (Android) into Aura repo

Goal

Create a new native Android app based on Google AI Edge Gallery (Kotlin/Compose), copied into this repo, then trim features and re-skin. Keep the same model stack used by Google’s app (LiteRT / AI Edge). No UI changes done now — this document is the plan only.

What we are comparing

• Current Aura app: React + Vite + Capacitor (web UI + Android shell)
• Google sample: Native Android Kotlin + Jetpack Compose app in other-samples/gallery-1.0.9/Android/src

These are different stacks. A direct “merge” is not realistic. The practical path is to replace the Android project with the Google sample and then customize it.

---

Essential files & folders in Google app

Root: other-samples/gallery-1.0.9/Android/src

Build system

• settings.gradle.kts
• build.gradle.kts
• gradle/ (wrapper config)
• gradlew, gradlew.bat
• gradle.properties
• app/build.gradle.kts (Android app config)

App source

• app/src/main/AndroidManifest.xml
• app/src/main/java/com/google/ai/edge/gallery/ (all Kotlin code)
• app/src/main/res/ (icons, strings, themes, drawables)

Config hooks (required to run)

• app/src/main/java/com/google/ai/edge/gallery/common/ProjectConfig.kt
  • clientId (Hugging Face OAuth)
  • redirectUri
• app/build.gradle.kts
  • manifestPlaceholders["appAuthRedirectScheme"]

Model allowlists

• other-samples/gallery-1.0.9/model_allowlist.json
• other-samples/gallery-1.0.9/model_allowlists/ (versioned)

---

Proposed conversion approach (copy-first)

Phase 1 — Create a new Android-native app base

1. Create a new branch (e.g., native-rebuild).
2. Copy the Google Android project into Aura:
   • Suggested target path: android-native/ (keeps current Capacitor android/ intact).
   • Copy from: other-samples/gallery-1.0.9/Android/src/* → android-native/
3. Open Android Studio on android-native/ to verify it builds (after config below).

Phase 2 — Make it runnable (no UI changes yet)

1. Create Hugging Face OAuth app.
2. Set values in:
   • android-native/app/src/main/java/.../ProjectConfig.kt (clientId, redirectUri)
   • android-native/app/build.gradle.kts (appAuthRedirectScheme)
3. Build debug APK using ./gradlew assembleDebug in android-native/.

Phase 3 — Identify what to keep vs remove

Keep (core):

• Model download + management flow
• Core LLM chat + inference + LiteRT stack
• Settings, model chooser, benchmarking (if useful)

Remove (likely):

• Tiny Garden mini‑game
• Mobile Actions demo
• Unneeded task cards / demos
• Extra demo prompts and showcase tiles

Phase 4 — Rebrand & reskin (later)

• Update colors, fonts, app name, icons in res/ and Compose themes
• Replace product strings, About text, and UI labels

---

Mapping: Aura vs Google app (high-level)

Area	Aura (current)	Google app (target)	Action
UI	React web	Compose native	Replace UI with Compose app
AI backend	Google GenAI cloud	LiteRT on-device	Keep Google LiteRT
Models	Gemini / Veo / TTS	LiteRT / HF downloads	Keep LiteRT models
Packaging	Capacitor Android shell	Full Android app	Switch to native app

---

Risks / Notes

• Licensing: Google app is Apache 2.0; check compliance when copying.
• Min SDK: Google app uses minSdk=31 (Android 12+). If you need older devices, it will require work.
• HF OAuth required: Model download flow depends on OAuth.
• Large codebase: It’s substantial; trimming should be planned carefully.

---

Next Steps (if you approve)

1. Create a new branch native-rebuild.
2. Copy Google Android project into android-native/.
3. Write a short checklist of which screens/features to keep.
4. Do a build once Hugging Face credentials are added.

---

Open Questions for you

• Should we replace the current Capacitor app, or keep it alongside (e.g., android/ + android-native/)?
• Which features from Google app do you want to keep/remove first?
• Do you want to keep the HF model download flow or use local/hosted models only?