EduLearn Mobile

EduLearn Mobile is the React Native app for EduLearn, built with Expo and Expo Router. It includes AI tutor chat, quizzes, flashcards, roadmaps, rewards, community, referrals, and user progression features.

EduLearn Repositories

• API: officialedulearn/edulearnapi
• Web: officialedulearn/web

Tech Stack

• Expo SDK 55
• React Native 0.83 / React 19
• Expo Router (file-based routing)
• Zustand (state management)
• Supabase JS client
• Socket.IO client

Core App Areas

• Authentication and onboarding
• AI chat and agent flows
• Quizzes and quiz leaderboard
• Flashcards
• Roadmaps and activity tracking
• Rewards and streaks
• Community hub
• Referrals
• Notifications
• Wallet and subscription screens

Prerequisites

• Node.js 18+
• npm
• Expo CLI via npx expo

Getting Started

1. Install dependencies:

   npm install

2. Create your local environment file:

   cp .env.example .env

   On Windows PowerShell:

   Copy-Item .env.example .env

3. Set the required values in .env:

   • EXPO_PUBLIC_SUPABASE_URL
   • EXPO_PUBLIC_SUPABASE_ANON
   • EXPO_PUBLIC_API_BASE_URL
   • EXPO_PUBLIC_TWITTER_CLIENT_ID

4. Start the app:

   npm run start

5. Run on a target platform from the Expo prompt (or use scripts below).

Scripts

• npm run start - start Expo dev server
• npm run android - run Android build
• npm run ios - run iOS build
• npm run web - run web target
• npm run lint - run lint checks

Project Structure

• app/ - routes and screens (Expo Router)
• components/ - reusable UI components
• core/ - Zustand stores and state
• services/ - API/service layer
• utils/ - helpers, constants, routing utilities
• assets/ - fonts, images, animations

Notes

• This app reads backend and auth configuration from app.config.js and .env.
• Keep secrets out of version control. Client-exposed values should use EXPO_PUBLIC_*.