Home
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 last_verified: 2026-08-06
🦉 3netra Meta Android App — Engineering Wiki
[!quote] Tagline See the World. Learn Without Limits.
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.)
[!info] Provenance Wiki implementation claims were audited 2026-08-06 from
origin/prodatb48aada8fd5427b5db0c02945569963c4ae543c8(2026-08-05, merge PR #11 cleanup). PRD and roadmap statements are explicitly non-implementation evidence. See 13-Source-Map-Glossary#Maintenance protocol.
📚 Pages
| # | Page | Contents |
|---|---|---|
| 1 | 01-Product-Overview | Mission, problem, goals/KPIs, personas |
| 2 | 02-System-Architecture | Architecture diagrams, repo layout, tech stack, backends |
| 3 | 03-Frontend-Navigation | Navigation graph, screen catalog, frontend flow chart |
| 4 | 04-User-Journeys | Student / teacher / caregiver journeys, gestures & voice |
| 5 | 05-Avatars-Companions | AI companion characters, voice personas |
| 6 | 06-Feature-Matrix | Implemented vs pending (PRD + roadmap) |
| 7 | 07-Services-APIs-Vendors | Full vendor/API inventory |
| 8 | 08-Data-Model-Supabase | Tables, columns, compliance (FERPA/COPPA) |
| 9 | 09-Design-System | Palette, typography, accessibility rules |
| 10 | 10-Engineering-Ops | Build, test, deploy, config keys, known quirks |
| 11 | 11-Security-Privacy-Compliance | Data classification, trust boundaries, FERPA/COPPA controls |
| 12 | 12-Risks-Decisions | Risk register, open architecture decisions |
| 13 | 13-Source-Map-Glossary | Code→capability map, org doc sources, glossary |
Archive
An earlier audit-style draft of this wiki is preserved in wiki/archive/ for reference.
⚡ 60-Second Summary
- 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
SupabaseAiServicediscards 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 Supabasechat-vision; the AWS/api/chatclient/prototype is unreferenced by production app code. - Privacy status: cloud
face_embeddingsare 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.
🗂 Key Facts
| 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. %%
