English Connection

An English-learning platform for Indian learners — Jumble Words (sentence building), Pronunciation Coach (per-word feedback), AI Partner (voice conversations with the tutor K.AI on Google Gemini Live), XP/levels/badges/leaderboard, and Pro access.

App + API	Next.js 16 (frontend/), deployed on Vercel
Data + Auth	Supabase — Postgres (supabase/migrations/) + Auth (Google, email/password)
AI	Gemini Live gemini-3.1-flash-live-preview (voice), gemini-3.1-flash-lite (scoring) via a key pool
Storage	Cloudflare R2 (recordings)

Start here

• Product & architecture wiki: docs/wiki/index.md
• Why things are the way they are: docs/memory/DECISIONS.md
• Current status / what's next: docs/memory/STATUS.md
• Run it locally / migrations / keys: docs/wiki/operations/runbook.md

cd frontend
cp .env.example .env.local          # fill in values
npx -y [email protected] install
npx -y [email protected] dev              # http://localhost:3000

Secrets never go in git: credentials.txt and every .env* (except .env.example) are ignored.