8000 GitHub - leonartist7/ARO.club · GitHub
[go: up one dir, main page]

Skip to content
leonartist7Public

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

672 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ARO — Next.js migration preview

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.

ARO — The Human Opportunity Network

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.


🚀 Quick Start

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

# Lint
npm run lint

Open http://localhost:5173 to view the app.


✨ Features

  • 🏠 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

📚 Documentation

  • 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 handoff
  • ARO_CURRENT_STATE.md — current governed truth, blockers and next action
  • ARO_INFRASTRUCTURE.md — repository, Vercel and Supabase provider boundary
  • ARO_SPEC_INDEX.md — package registry and status vocabulary
  • ARO_IMPLEMENTATION_STATUS.md — verified implementation state by package
  • ARO_BUILD_PLAYBOOK.md — package execution rules and delivery sequence
  • VISION.md — why the product exists
  • DESIGN_SYSTEM.md — design tokens, accessibility, hero pages
  • DESIGN_EXECUTION_PLAN.md — how every screen looks, moves, feels
  • PAYMENTS_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.

🛠️ Tech Stack

  • 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

Environment Variables

VITE_SUPABASE_URL=your_supabase_url
VITE_SUPABASE_ANON_KEY=your_supabase_key
VITE_STRIPE_PUBLISHABLE_KEY=your_stripe_key

All other secrets live only in Supabase function config — never in git, never in client code.

📁 Project Structure

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)

🎨 Design System

  • Primary: Coral Orange (#FF6B35) — CTAs
  • Secondary: Teal (#20B2AA) — trust, links, money
  • Gold (#FFB020): gamification only
  • Typography: Poppins (headings), Inter (body)
  • Dark mode is the class strategy via ThemeContext — style with dark: variants.

🚀 Deployment

  1. Push code to GitHub
  2. Import repository on vercel.com
  3. Add the environment variables above
  4. Apply the SQL files in supabase/ (in order) to your Supabase project
  5. Deploy!

📄 License

MIT License - see LICENSE file for details


Learn a language. Make friends. Experience the world. 🌍✨

About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0