Learn with Alphonso
A full-stack mobile-first English, French, and Spanish learning app with gamification, AI-powered conversation practice, and a spaced repetition review system — web app plus native iOS and Android apps sharing the same backend/account.
Decoupled from Lovable hosting/tooling (TASK-078) as far as this repo's
code is concerned: AI calls go straight to OpenRouter/Deepgram (not a Lovable
gateway), and deploy targets Vercel.
Repo lives at github.com/obsidian-media/LearnWithAlphonso (transferred
from a personal account to the obsidian-media org to fix a GitHub
Actions billing block; the codebase's internal project name is still
english-buddy-app-33 in a few config/directory references — cosmetic
only, not worth a mass rename). Vercel's own GitHub integration was
not carried over by that transfer, then reconnected the same day
(2026-09-20) — see "Deployment" below for what's confirmed vs. what
still needs a real push to verify.
Tech Stack
| Layer | Technology |
|---|
| Framework | TanStack Start (SSR) + React 19 + Vite 8 |
| Styling | Tailwind CSS v4 + hand-written components + Framer Motion |
| State | Zustand (client) + TanStack Query (server) |
| Backend | Supabase (PostgreSQL + Auth + RLS + RPCs) |
| AI | OpenRouter chat with an ordered model fallback list (default anthropic/claude-haiku-5.5 on the owner's own Anthropic key, reasoning turned off on every call) + Deepgram Aura-2/Nova-3 (TTS/STT), all called directly |
| Routing | TanStack Router (file-based) |
| Testing | Vitest (unit) + Playwright + axe-core (E2E/accessibility) |
| Package manager | bun (bun.lock is authoritative; no package-lock.json) |
See ARCHITECTURE.md for the full request flow, database schema, and design notes.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
