Back to Projects
The Jamb Master
Engineering

The Jamb Master

Full-Stack Developer

Next.jsMongoDBJWTTypeScript

About the Project

The Jamb Master is a production-grade CBT (Computer-Based Test) exam preparation platform for Nigeria's JAMB exams. It combines a marketing site with a complete student learning portal — students register, select their track (Science/Art/Commercial), take timed mock exams across 12 subjects, review detailed results with explanations, and compete on leaderboards. Admins manage tests, questions (with image support), and monitor student performance through a dedicated dashboard.

What It's Made Of

Student portal

Next.js 16 · React 19 · JWT auth

Registration, track selection across Science, Art and Commercial, subject choice across the twelve supported subjects, timed mock exams under JAMB-style conditions, detailed result review with explanations, attempt history, and profile management. The exam runner is the heart of it: a real-time timer, duplicate-submission protection, and graceful timeout handling, because an exam session that loses a student's answers is the one bug that cannot be forgiven.

Admin dashboard

Separate JWT flow · question authoring

Test and question management: composing tests, authoring questions with images, comprehension passages and explanations, publishing or withholding them, and monitoring student performance. It runs on its own authentication flow rather than an elevated student role, so the two user types never share a session boundary.

Marketing site

Admin-configurable content · pixel tracking

The public front with content the admin can change without a deploy, plus Facebook and TikTok pixel tracking for the paid acquisition that drives sign-ups. Lives in the same app as the portal but behind its own route group and middleware.

Scoring & leaderboards

0-400 JAMB scale · per-subject breakdown

Scoring on the real 0-400 JAMB scale with per-subject breakdowns, feeding a cross-student leaderboard. Keeping scoring as its own concern is what makes the breakdown and the ranking consistent rather than two separate calculations of the same attempt.

Key Highlights

  • Full CBT mock exam simulation with JAMB-style scoring (0-400 scale) and real-time timer
  • Student portal: registration, track/subject selection, practice tests, attempt history, and profile management
  • Leaderboard system with competitive rankings across all students
  • Admin test management: create tests, add questions with images/passages/explanations, publish and monitor
  • 12 JAMB subjects supported (Math, English, Physics, Chemistry, Biology, Economics, and more)
  • Dual authentication system (JWT) for both admin and student users with middleware-protected routes
  • Marketing site with dynamic admin-configurable content, Facebook and TikTok pixel tracking
  • Exam session management with timeouts and subject-based score breakdowns

Technical Challenges

Building a dual-user platform (admin + student) with separate auth flows, real-time exam session management, and accurate scoring required careful architecture. The exam session system needed to handle timeouts gracefully, prevent duplicate submissions, and provide per-subject score breakdowns — all while keeping the interface fast enough to simulate real JAMB exam conditions.