LearnSight is an adaptive learning platform that diagnoses student strengths and weaknesses across four fundamentals — Listening, Grasping, Retention, and Application — and generates personalized practice plans with real-time progress reports for students, teachers, and parents.
- 🎯 Adaptive Diagnostic Test – 10–15 questions that dynamically adjust difficulty.
- 🧩 Skill Mapping – Every response is mapped to fundamentals: listening, grasping, retention, and application.
- 📊 Personalized Reports – Radar charts and simple recommendations for each student.
- 📝 Targeted Practice Queue – Micro-lessons (2–5 problems each) generated for each weak skill.
- 👩🏫 Teacher Dashboard – Class overview with exportable reports.
- 👨👩👧 Parent Access – A simple view of the student’s progress and support suggestions.
- Next.js (App Router)
- TailwindCSS for rapid UI styling
- Recharts for interactive graphs
- Firebase Auth – Authentication
- Firestore – Database & Adaptive logic
- Render – Hosting
- OpenAI API – For explanations, hints, and micro-lesson generation.
learnsight/
app/
├── api/
├── auth/
├── signup/
└── route.ts
└── verify/
└── route.ts
├── diagnostic/
├── attempt/
└── latest/
└── route.ts
├── complete/
└── route.ts
├── get-attempt/
└── route.ts
├── next-question/
└── route.ts
├── start-attempt/
└── route.ts
└── submit-answer/
└── route.ts
├── paper/
└── [id]/
└── route.ts
├── practice/
├── generate/
└── route.ts
├── session/
└── [id]/
└── route.ts
└── sessions/
└── route.ts
├── questions/
└── [id]/
└── route.ts
├── student/
└── [id]/
├── dashboard/
└── route.ts
├── radar/
└── route.ts
├── reports/
└── route.ts
└── update/
└── route.ts
└── teacher/
└── [id]/
├── alerts/
└── route.ts
├── dashboard/
└── route.ts
├── reports/
└── route.ts
└── students/
└── route.ts
├── dev-auth/
└── page.tsx
├── login/
├── loading.tsx
└── page.tsx
├── parent/
├── dashboard/
└── page.tsx
├── progress/
└── page.tsx
└── support/
└── page.tsx
├── student/
├── dashboard/
└── page.tsx
├── diagnostic/
└── page.tsx
├── practice/
├── [id]/
└── page.tsx
└── page.tsx
├── profile/
└── page.tsx
└── reports/
└── page.tsx
├── teacher/
├── dashboard/
└── page.tsx
├── reports/
└── page.tsx
└── students/
├── loading.tsx
└── page.tsx
├── globals.css
├── layout.tsx
└── page.tsx
components/
├── layout/
├── footer.tsx
└── navbar.tsx
├── ui/
├── badge.tsx
├── button.tsx
├── card.tsx
├── input.tsx
├── label.tsx
├── loader.tsx
├── progress.tsx
├── radio-group.tsx
├── select.tsx
├── sheet.tsx
├── table.tsx
├── tabs.tsx
└── textarea.tsx
├── auth-guard.tsx
├── dashboard-layout.tsx
├── practice-card.tsx
└── radar-chart.tsx
contexts/
└── user-context.tsx
lib/
├── auth-context.tsx
├── auth.ts
├── auth.ts.new
├── db-admin.ts
├── firebase-admin.ts
├── firebase.ts
├── teacher-service-client-part2.ts
├── teacher-service-client.ts
├── teacher-service.ts
└── utils.ts
scripts/
├── create-demo-users.js
└── seed-demo.ts
types/
├── index.ts
└── teacher.ts
utils/
├── adaptive.ts
├── practice.ts
└── scoring.ts
.eslintrc.json
.gitignore
components.json
eslint.config.mjs
firestore.indexes.json
firestore.rules
next.config.ts
package-lock.json
package.json
postcss.config.mjs
README.md
tsconfig.json-
Clone the repository
git clone https://github.com/dipexplorer/learnsight.git cd learnsight -
Install dependencies
npm install
-
Set up environment variables Create a
.env.localfile in the root directory and add your credentials:NEXT_PUBLIC_FIREBASE_API_KEY=your_key NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=your_project.firebaseapp.com NEXT_PUBLIC_FIREBASE_PROJECT_ID=your_project_id NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET= NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID= NEXT_PUBLIC_FIREBASE_APP_ID= NEXT_PUBLIC_FIREBASE_MEASUREMENT_ID= FIREBASE_PROJECT_ID= FIREBASE_CLIENT_EMAIL= FIREBASE_PRIVATE_KEY=
-
Run the development server
npm run dev
Open http://localhost:3000 in your browser. 🚀
Student login → Adaptive Diagnostic → Radar Report → Personalized Practice Plan generated live.
Teacher Dashboard: Compare students (e.g., Ram, Shyam, Sanga).
Parent Dashboard: View simple progress and recommendations.
flowchart TD
A[Student] -->|Diagnostic Test| B[Adaptive Engine]
B -->|Update Skills| C[(Firestore DB)]
C --> D[Reports Service]
D -->|Radar/Insights| E[Student Dashboard]
D --> F[Teacher Dashboard]
D --> G[Parent Dashboard]
B --> H[Practice Generator]
H -->|Tasks + Micro-lessons| E
H -->|LLM optional| I[(OpenAI API)]
- Innovation & Creativity (30%) – Adaptive engine combined with AI-powered micro-lessons.
- Technical Implementation (30%) – Modern stack with Firebase, Next.js, and custom adaptive logic.
- Relevance (20%) – Directly measures and improves fundamental learning skills.
- Clarity (20%) – Clean dashboards and a demo-ready user flow.
Built with ❤️ by [BrainBots] for [Ai for Education].
This project is licensed under the MIT License. You are free to use, modify, and distribute it with attribution.