title: 3netra Meta Android App — Engineering Wiki

aliases: [3netra Wiki, Meta App Wiki, Home]

tags: [3netra/wiki, moc]

product: 3netra Meta Android App

source_repository: 3Netra-ai/3n_meta_android

source_ref: origin/prod

source_revision: b48aada8fd5427b5db0c02945569963c4ae543c8

AI-powered learning companion for blind & visually impaired higher education students (high school and college), pairing **Meta Ray-Ban smart glasses** with a native **Kotlin/Jetpack Compose Android app**.

Canonical source repo: `3Netra-ai/3n_meta_android` · Package: `com.threenetra.app` · Status: active development. (The inspected local checkout is named `archived-3n-meta-app`.)

---

| # | Page | Contents |

|---|------|----------|

| 1 | [[01-Product-Overview\|Product Overview]] | Mission, problem, goals/KPIs, personas |

| 2 | [[02-System-Architecture\|System Architecture]] | Architecture diagrams, repo layout, tech stack, backends |

| 3 | [[03-Frontend-Navigation\|Frontend & Navigation]] | Navigation graph, screen catalog, frontend flow chart |

| 4 | [[04-User-Journeys\|User Journeys]] | Student / teacher / caregiver journeys, gestures & voice |

| 5 | [[05-Avatars-Companions\|Avatars & Companions]] | AI companion characters, voice personas |

| 6 | [[06-Feature-Matrix\|Feature Matrix]] | Implemented vs pending (PRD + roadmap) |

| 7 | [[07-Services-APIs-Vendors\|Services, APIs & Vendors]] | Full vendor/API inventory |

| 8 | [[08-Data-Model-Supabase\|Data Model (Supabase)]] | Tables, columns, compliance (FERPA/COPPA) |

| 9 | [[09-Design-System\|Design System]] | Palette, typography, accessibility rules |

| 10 | [[10-Engineering-Ops\|Engineering Ops]] | Build, test, deploy, config keys, known quirks |

| 11 | [[11-Security-Privacy-Compliance\|Security, Privacy & Compliance]] | Data classification, trust boundaries, FERPA/COPPA controls |

| 12 | [[12-Risks-Decisions\|Risks & Decisions]] | Risk register, open architecture decisions |

| 13 | [[13-Source-Map-Glossary\|Source Map & Glossary]] | Code→capability map, org doc sources, glossary |

---

- **What is wired:** Compose screens attempt glasses capture, Supabase Edge Function invocation, Android speech, face enrollment/matching, chat, notes, and in-memory story UI. At this revision `SupabaseAiService` discards every successful model reply and returns fixed success text; those assistance flows are not verified as useful end-to-end.

- **How:** Native Kotlin app (`src/frontend/`) — single activity, Jetpack Compose, service-singleton architecture. Meta **MWDAT 0.7.0** capture/registration code is present, but gesture callbacks and hardware behavior are untested. Active AI calls target Supabase `chat-vision`; the AWS `/api/chat` client/prototype is unreferenced by production app code.

- **Privacy status:** cloud `face_embeddings` are the active enrollment/matching path. Local encrypted 90-day storage is unreferenced; schema/RLS/consent claims are not proven. See [[08-Data-Model-Supabase]].

- **Mascot:** Netra the Owl 🦉 (+ Cosmo, Sage, Ripple companions). See [[05-Avatars-Companions]].

| Fact | Value |

|---|---|

| Primary codebase | `src/frontend/` (Kotlin, Compose) — minSdk 29, target 34, compile 35 |

| Secondary tree | `android/` — Expo/React Native shell (vestigial; JS sources absent) |

| Glasses SDK | Meta Wearables DAT (MWDAT) `0.7.0` — core, camera, mockdevice |

| Backend DB/Auth | Supabase (Postgres 17, GoTrue, PostgREST, Realtime) |

| Active AI path | Supabase `chat-vision` Edge Function → OpenAI `gpt-4o`; Android client currently discards the response |

| Voice (Indic) | Sarvam.ai (translate / TTS speaker "meera" / STT "saaras:v1") |

| Face recognition | FaceNet TFLite + cosine comparison against Supabase-fetched embeddings (threshold 0.5) |

| Legacy paths | Firebase Cloud Functions + Vercel function (Resend welcome emails) |

%%

Tags index: #3netra/wiki — all pages in this folder belong to the wiki MOC.

%%