wosmo
← all projects

project 02 of 09 · web · university

Learnity

Online Tutoring Platform with Gamified Learning (FYP)

● live · learnity-app.vercel.appsince 2025pushed 74d ago

Connects students with verified tutors — custom gamification engine (XP, streaks, progression), real-time HD video via GetStream, and role-based access control. Final Year Project, shipped solo.

Learnity screenshot
screenshot · learnity-app.vercel.app ↗

About

from the readme on github
  • Built an end-to-end online tutoring platform (learnity-app.vercel.app) connecting students with verified tutors for personalised 1-on-1 sessions and synchronous study groups.
  • Engineered a custom gamification engine, XP system, streak multipliers, and progression formulas, designed around behavioural-engagement loops that reward consistent learning.
  • Integrated GetStream for real-time HD video tutoring; implemented role-based access control across Students, Teachers, and Admins with isolated permission scopes.
  • Owned the product end-to-end, schema, backend, authentication, real-time video, gamification, and the full Next.js 15 (SSR / ISR / App Router) frontend, shipping a complete EdTech product solo.

A full-stack learning management system — course authoring, enrolment and progress tracking, live video classrooms, real-time chat, quizzes with server-side grading, PDF certificates, an internal wallet, gamification, and an admin console with audit logging.

Live: learnity-app.vercel.app

Built with Next.js 16 (App Router), TypeScript in strict mode, Prisma over PostgreSQL, and Better Auth.

> Read the Known limitations section before evaluating this project. Some > features are complete and some are deliberately unfinished, and this README says which is which. > The demo catalogue is generated seed data, not curated content.

Try it

These are seeded demo accounts on a throwaway database and all share one password by design. The first request after a quiet period may take a few seconds — the database is Neon serverless and suspends when idle.

Features

Status is marked honestly: ✅ working end-to-end against real data · ◐ partial with a known gap · ○ stubbed UI only.

Student

  • ✅ Course catalogue — server-rendered search, category/difficulty/rating filters, sorting, pagination
  • ✅ Enrolment — free and paid. Paid enrolment debits the student wallet, credits the teacher, and writes both WalletTransaction rows inside a single Prisma transaction with a balance check
  • ✅ Course player — YouTube lessons with resume position, watch-time persistence, and sequential lesson locking
  • ✅ Progress tracking — per-lesson completion recomputes enrolment percentage, awards XP, and updates the streak
  • ✅ Quizzes — multiple-choice with server-side grading against a per-quiz passingScore, per-answer results, and retries
  • ✅ Reviews — gated behind ≥50% course progress
  • ✅ Gamification — XP, levels, a 35-day activity heatmap, and global + per-course leaderboards with your own rank
  • ✅ Live classrooms — 100ms group video rooms per course, plus Stream-powered course chat and direct messages *(requires 100ms + Stream keys)*
  • ✅ Tutoring requests — book a 1-on-1 session with a teacher
  • ✅ Profile — bio, subjects, goals, avatar upload, privacy settings
  • ◐ Wallet — balance and transaction history work; manual top-up submits a receipt for admin approval
  • ○ Joining a tutoring video call — returns a placeholder token; the group classrooms are the real implementation

Built with

github language bytes · live
composition
TypeScript99.5%CSS0.4%Shell0.1%JavaScript0.0%
stack
Next.js 15TypeScriptPostgreSQLGetStreamTailwind CSSFirebase