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/prod at b48aada8fd5427b5db0c02945569963c4ae543c8 (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
Note

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 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.

🗂 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. %%