An intelligent, bilingual (English 🇬🇧 / Bangla 🇧🇩) learning ecosystem that adapts to every learner — from Class 1–12 to admission tests, government jobs, and skill development.
EduOrbit AI is the frontend of a modern exam-preparation platform that uses AI to analyze student performance, generate personalized practice, and deliver an engaging, gamified learning experience. It serves four distinct roles — Students, Teachers, Schools, and Admins — through tailored dashboards, all under a single unified learning hierarchy.
The platform connects to a FastAPI backend (for users, questions, and analytics) and uses Google Genkit AI flows for adaptive practice, note generation, and weakness analysis.
| Feature | Description |
|---|---|
| 🤖 AI Adaptive Exam Engine | Analyzes performance to generate personalized practice and real-time readiness scoring. |
| 🎯 Unified Learning Tracks | Classes 1–12, Admission Tests, Global Exams, Government Jobs, and Skill Development in one hierarchy. |
| 📝 Hybrid Examination Hub | Timed MCQ exams with instant feedback and rich-text written-exam submissions. |
| ⚔️ Battleground | Competitive, gamified exam arena with stats, leaderboards, and per-school showdowns. |
| 🏆 Public Leaderboard | Real-time student rankings to drive motivation and friendly competition. |
| 💬 Community Chat | Moderated peer chat with bad-word filtering and time-boxed sessions. |
| 🗒️ AI Note Generator | Generates structured study notes and a personal "weakness notebook" from past mistakes. |
| 🧮 Math & Science Ready | Full LaTeX / KaTeX rendering and MathLive input for STEM subjects. |
| 🌐 Bilingual Locale Switcher | Seamless real-time switching between English and Bangla across the whole app. |
| 🔐 Tri-Role + School Portals | Secure, role-based dashboards for Students, Teachers, Schools, and Admins. |
Add the screenshots below into a
docs/screenshots/folder and keep the file names as listed so the links resolve automatically.
| Login | Register |
|---|---|
 |
 |
| School Dashboard | Battle Ground |
|---|---|
 |
 |
| Live Exam (MCQ + Timer) | Results & Feedback |
|---|---|
 |
 |
| Leaderboard | Community Chat |
|---|---|
 |
 |
| Note Generator | AI Chatbot |
|---|---|
 |
|
Framework & Language
- Next.js 15 (App Router, Turbopack) · React 19 · TypeScript 5
Styling & UI
- Tailwind CSS 3 · Radix UI primitives · Framer Motion · Lucide Icons · Recharts
AI & Content
- Tesseract.js (OCR) · KaTeX + MathLive (math) · TipTap (rich-text editor)
Backend & Data
- Firebase (Auth) · FastAPI backend (REST, via
NEXT_PUBLIC_API_URL) · Zod + React Hook Form (validation)
- Node.js 18+ and npm
- A Firebase project (for authentication)
- The FastAPI backend running (default:
http://localhost:8000)
git clone <your-repo-url>
cd EduOrbit_Hack
npm installCopy the example env file and fill in your values:
cp .env.local.example .env.local# Backend API
NEXT_PUBLIC_API_URL=http://localhost:8000
# Firebase
NEXT_PUBLIC_FIREBASE_API_KEY=your_firebase_api_key
NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=your_project.firebaseapp.com
NEXT_PUBLIC_FIREBASE_PROJECT_ID=your_project_id
NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=your_project.appspot.com
NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=your_sender_id
NEXT_PUBLIC_FIREBASE_APP_ID=your_app_idnpm run devThe app runs at http://localhost:9002.
npm run genkit:dev # start Genkit dev UI
npm run genkit:watch # with hot reload| Script | Description |
|---|---|
npm run dev |
Start the Next.js dev server (Turbopack) on port 9002. |
npm run build |
Create a production build. |
npm run start |
Start the production server. |
npm run lint |
Run ESLint. |
npm run typecheck |
Run TypeScript type checking (tsc --noEmit). |
npm run genkit:dev |
Launch the Genkit AI development environment. |
npm run genkit:watch |
Launch Genkit AI with hot reload. |
EduOrbit_Hack/
├── docs/
│ ├── blueprint.md # Product blueprint & style guidelines
│ └── screenshots/ # 📸 Add your screenshots here
├── src/
│ ├── ai/ # Genkit AI flows
│ │ └── flows/ # adaptive-practice, note-generator, weakness-notebook
│ ├── app/ # Next.js App Router pages
│ │ ├── academic/ # Class 1–12 track
│ │ ├── admission/ # Admission tests
│ │ ├── gov-jobs/ # Government job prep
│ │ ├── skills/ # Skill development
│ │ ├── exam-hub/ # Hybrid examination engine
│ │ ├── battleground/ # Gamified exam arena
│ │ ├── community/ # Moderated community chat
│ │ ├── leaderboard/ # Public rankings
│ │ ├── note-generator/ # AI note generation
│ │ ├── dashboard/ # student | teacher | school | admin
│ │ ├── login/ · register/ # Authentication
│ │ └── page.tsx # Landing page
│ ├── components/ # UI, layout, auth, chatbot, editor, voice, home
│ ├── context/ # Global app context (language, etc.)
│ ├── firebase/ # Firebase config, providers & auth hooks
│ ├── hooks/ # Custom React hooks
│ ├── lib/ # API clients, books/chapter data, translations, utils
│ └── types/ # Shared TypeScript types
├── next.config.ts
├── tailwind.config.ts
└── package.json
EduOrbit AI ships fully bilingual. All UI strings live in src/lib/translations.ts, and the active language is managed via the global app context — switchable in real time from the navbar.
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Commit your changes:
git commit -m "Add amazing feature" - Push to the branch:
git push origin feature/amazing-feature - Open a Pull Request
Built with ❤️ for learners everywhere.
⭐ Star this repo if you find it useful!