Nigeria's Premier AI-Powered CBT Platform | Results as a Service
# SchoolCBT — Nigeria's Premier AI-Powered CBT Platform
> **Results as a Service** — Multi-agent AI prepares Nigerian students for JAMB, WAEC, NECO & NABTEB with personalized question batches, predictive pass analytics, tutor matching, and automated report cards.
---
## Tech Stack
| Layer | Technology |
| ------------ | -------------------------------------------------------------------------- |
| Framework | SvelteKit 5 (Svelte 5 runes — `$state`, `$derived`, `$props`, `$bindable`) |
| Language | TypeScript 5.4 strict |
| Styling | Tailwind CSS 3.4 + glassmorphism design system (529-line `app.css`) |
| Auth | Firebase Auth (email/password, OTP, email verification, role-based) |
| Real-time DB | Convex (8 tables, typed schema, real-time subscriptions) |
| AI Engine | Gemini 1.5 Flash via `api/generate/+server.ts` |
| Payments | Paystack, Stripe, Flutterwave, KoraPay, Seerbit |
| Email | Resend (transactional: welcome, password reset, payment confirmation) |
| Validation | Zod (runtime type safety on all API endpoints) |
| Testing | Vitest (37 unit tests) + Playwright (E2E) |
| Deployment | Cloudflare Pages via `@sveltejs/adapter-cloudflare` |
| CI/CD | GitHub Actions (lint → build → deploy → Docker) |
---
## Quick Start
```bash
git clone
github.com
cd SchoolCBT
cp .env.example .env.local # fill in your keys
npm install --legacy-peer-deps
npm run dev #
localhost
```
### Scripts
| Command | Purpose |
| ----------------------- | ------------------------------------- | …