Use Node.js 24.15 or newer. Run npm ci, npm run dev, npm run build and npm start. Validate with npm run lint, npm run type-check, npm test and npm run test:e2e. Existing F4–F6 production browser suites run after a build with FV1_BROWSER_EVIDENCE=true.
See deployment audit and rollout specification. Accounts remain staging-only; copy names from .env.example into ignored local configuration. Provider values never belong in Git.
Learn languages through real experiences with local teachers in cities around the world.
ARO helps human intent, capability, people, place and time form into meaningful real-world opportunity. Tonguee is ARO's first live vertical, connecting language learners with verified local teachers for small-group experiences in authentic settings such as cafés, markets, walking tours and cultural activities. Coco the Chameleon remains Tonguee's vertical guide.
# Install dependencies
npm install
# Start development server
npm run dev
# Build for production
npm run build
# Lint
npm run lintOpen http://localhost:5173 to view the app.
- 🏠 Hero homepage with featured experiences and animated stats
- 🔍 Explore with search & filtering by language, city, skill level, and price
- 🗺️ Experience marketplace with teacher profiles, reviews, and gamification loop
- 🔐 Auth (Supabase Auth) with student & teacher onboarding
- 🛡️ Trust Engine — verified-only teacher publishing (database-enforced), tiered verification (Verified / Pro / Top Tongue), application review queue, admin audit log
- 👤 Admin panel — users, teachers, experiences, bookings, reviews, revenue, audit log
- 🎮 Gamification — points, badges, leaderboard, character builder, shop
- 📘 Passport — track your learning journey
- 🌓 Dark mode, i18n, accessibility (keyboard + reduced-motion), fully responsive
- ⚖️ Legal pages — terms, privacy, cookies
- FV-1 proposed recovery handoff — recovered synthesis, bounded task packets and provenance; SPEC-REQUIRED, not implementation approval
AGENTS.md— operating contract for contributors and agents (read first)ARO_MASTER_DELIVERY_PLAN.md— canonical V1 delivery objective, phase map, gates and cloud-task handoffARO_CURRENT_STATE.md— current governed truth, blockers and next actionARO_INFRASTRUCTURE.md— repository, Vercel and Supabase provider boundaryARO_SPEC_INDEX.md— package registry and status vocabularyARO_IMPLEMENTATION_STATUS.md— verified implementation state by packageARO_BUILD_PLAYBOOK.md— package execution rules and delivery sequenceVISION.md— why the product existsDESIGN_SYSTEM.md— design tokens, accessibility, hero pagesDESIGN_EXECUTION_PLAN.md— how every screen looks, moves, feelsPAYMENTS_SPEC.md— money, bookings, payouts, refunds (Phase C, not yet merged)
New cloud tasks must read AGENTS.md and ARO_MASTER_DELIVERY_PLAN.md before selecting implementation work. The master plan defines sequencing; an approved package specification remains the authority for runtime changes.
- Frontend: React 19 + Vite
- Styling: Tailwind CSS v3
- Routing: React Router v7 (lazy routes in
src/lib/routes.jsx) - State Management: Zustand
- Animations: Framer Motion
- Icons: Lucide React
- Backend: Supabase (Postgres + RLS + Edge Functions)
- Date Handling: date-fns
VITE_SUPABASE_URL=your_supabase_url
VITE_SUPABASE_ANON_KEY=your_supabase_key
VITE_STRIPE_PUBLISHABLE_KEY=your_stripe_keyAll other secrets live only in Supabase function config — never in git, never in client code.
src/
├── components/
│ ├── admin/ # Admin panel layout, charts, pager
│ ├── auth/ # ProtectedRoute, AdminRoute
│ ├── features/ # ExperienceCard, TeacherCard
│ ├── layout/ # Header, Footer, Layout
│ └── ui/ # Button, Card, Badge, Input, etc.
├── data/ # Seed data
├── i18n/ # Translations
├── pages/ # Route pages (incl. pages/admin/*)
├── store/ # Zustand state management
├── utils/ # Helper functions (cn, formatters)
└── lib/ # Config, routes, Supabase clients, data layers
supabase/
├── schema.sql # Base schema (append-only)
├── trust-engine.sql # Trust Engine: verified gate, RLS, audit log
├── admin-panel.sql # Admin panel RLS (append-only)
└── langgie-extensions.sql # Extensions (append-only)
- Primary: Coral Orange (#FF6B35) — CTAs
- Secondary: Teal (#20B2AA) — trust, links, money
- Gold (#FFB020): gamification only
- Typography: Poppins (headings), Inter (body)
- Dark mode is the
classstrategy viaThemeContext— style withdark:variants.
- Push code to GitHub
- Import repository on vercel.com
- Add the environment variables above
- Apply the SQL files in
supabase/(in order) to your Supabase project - Deploy!
MIT License - see LICENSE file for details
Learn a language. Make friends. Experience the world. 🌍✨