ZeroQCM

La révision médicale, réinventée.

Free, AI-powered QCM platform for Moroccan medical students —
S1 through S10, 215 000+ questions, built to replace MonQCM and DariQCM.

Overview

ZeroQCM is a free, open-source medical revision platform built specifically for students at Moroccan medical faculties (FMPC, FMPR, FMPT, FMPK, FMPM and others). It aggregates 215 000+ validated QCM questions spanning all years of the premier cycle — both odd and even semesters — provides AI-powered per-option explanations via GitHub Models, and tracks each student's progress with a spaced-repetition algorithm — completely free, no account paywall.

"وَاللَّهُ أَخْرَجَكُم مِّن بُطُونِ أُمَّهَاتِكُمْ لَا تَعْلَمُونَ شَيْئًا وَجَعَلَ لَكُمُ السَّمْعَ وَالْأَبْصَارَ وَالْأَفْئِدَةَ لَعَلَّكُمْ تَشْكُرُونَ" — An-Nahl 16:78

Why ZeroQCM?

Morocco has ~35,000 medical students across 7 faculties. The existing platforms (DariQCM, MonQCM) require institutional access, are paywalled, or don't support all faculties. There is no free, unified, open-source repository of Moroccan medical QCMs. ZeroQCM fills that gap — permanently free, self-hostable, open source.

Features

🎯 Core Quiz Engine

Feature	Details
QCM + QROC	Multiple-choice and open-response questions supported
Multi-select	Handles questions with multiple correct answers
Keyboard navigation	`A`–`E` to select, `Enter` to confirm, `←/↑` to navigate
Swipe gestures	Native touch swipe for mobile navigation
Instant feedback	Correct/incorrect revealed immediately with color-coded options
Question counter	Progress indicator across full module sessions

🧠 AI Explanations

Feature	Details
Per-option AI explain	Tap any option to get a tailored explanation for why it's right or wrong
GitHub Models backend	Server-side PAT — no API key required from the user
Streaming responses	Token-by-token streaming for instant perceived performance
Shared cache	Explanations stored in Supabase `ai_explanations` table, shared across all users
Model picker	Settings page dynamically lists available GitHub Models (GPT-4o, o3-mini, Llama 3.3 70B, Phi-4…)
60s timeout	`maxDuration = 60` on the API route prevents Vercel Hobby tier stream kills

📊 Progress & Spaced Repetition

Feature	Details
Stats dashboard	Animated SVG rings — total answered, success rate, streak
Daily streak	Consecutive revision days tracked
Révision ciblée	`/revision` — lists weak modules (failed 2+ times), launches focused sessions
Per-module error badges	Visual indicator of error count per module
Reset stats	One-tap reset with confirmation sheet — wipes all `user_answers` for the account

📚 Student Community

Feature	Details
Bookmarks	Save any question during quiz with one tap — review later from `/bookmarks`
Comments	Per-question discussion thread — share tips, corrections, and mnemonics with peers
Leaderboard	Anonymous ranking by total correct answers and daily streak — podium top 3 + full list
Study Rooms	Real-time collaborative revision rooms (Supabase Realtime)
Flashcards	SM-2 spaced repetition flashcard system
Module Certificates	Bronze/Silver/Gold tier certificates with HD shareable OG images

📋 Rich Content Rendering

Feature	Details
Markdown tables	Questions with `\|` pipe tables render as formatted HTML tables
Inline formatting	`bold`, `italic`, `code`, `^superscript`, `_subscript`
Bullet & numbered lists	Lists in question text render as styled list items
Multiline blocks	Double-newline paragraph breaks preserved in questions and choices

🎨 Design System

Feature	Details
Dark / Light mode	System-aware with manual toggle, persisted to `localStorage`
CSS custom properties	Full design token system — no hard-coded colors anywhere
Framer Motion	Staggered entrance animations, spring-based micro-interactions
Apple-style aesthetics	Hairline borders, negative space, monochrome palette
Fully responsive	Optimized for mobile, tablet, and desktop
Scanline 404	Medical EKG flatline 404 page — full EKG trace → flatline → defibrillator CTA

🔐 Auth & Profiles

Feature	Details
Supabase Auth	Email + password, no email verification required
Auto-profile trigger	PostgreSQL trigger creates `profiles` row on signup
Year of study	`annee_etude` (1–5) gates which semesters appear in the sidebar
RLS policies	Row-level security on all user data tables
Activation system	Key-gated access with admin approval dashboard

Database

215 000+ questions · 2 faculties (FMPC + FMPM) · full S1–S10 coverage

Semester	Year	Faculty	Questions
S1	Year 1	FMPC, FMPM, FMPR, UM6SS, FMPDF	~43 985
S2 ✨	Year 1	FMPC, FMPM	~21 985
S3	Year 2	FMPC, FMPM, FMPR, UM6SS	~36 473
S4 ✨	Year 2	FMPC, FMPM	~12 115
S5	Year 3	FMPC, FMPM, FMPR, UM6SS	~38 536
S6 ✨	Year 3	FMPC, FMPM	~9 996
S7	Year 4	FMPC, FMPM, FMPR, UM6SS	~26 144
S8 ✨	Year 4	FMPC, FMPM	~10 520
S9	Year 5	FMPC, FMPM, FMPR, UM6SS	~18 962
S10 ✨	Year 5	FMPC, FMPM	~11 963
Total			~215 699

✨ = Even semesters added March 2026

Schema

semesters       id, semestre_id, nom, faculty, total_modules, total_questions
modules         id, module_id, semester_id, nom, total_questions, total_activities
activities      id, activite_id, module_id, nom, type_activite, chapitre
questions       id, id_question, activity_id, module_id, texte, source_type, correction
choices         id, id_choix, question_id, contenu, est_correct, pourcentage
profiles        id (→ auth.users), full_name, annee_etude, preferences (jsonb)
user_answers    id, user_id, question_id, choice_id, is_correct, answered_at
ai_explanations id, prompt_hash, response, model, created_at
comments        id, question_id, user_id, content
comment_likes   id, comment_id, user_id
study_rooms     id, name, created_by, is_active
flashcard_sessions id, user_id, module_id, card_data (jsonb)
module_certificates id, user_id, module_id, score, tier (bronze/silver/gold)
activation_keys id, key, created_by, used_by, used_at

Tech Stack

Layer	Technology
Framework	Next.js 15 (App Router)
Language	TypeScript 5
Styling	Tailwind CSS + CSS custom properties
Animations	Framer Motion
Database	Supabase (PostgreSQL + RLS + Auth)
AI	GitHub Models (server-side PAT, no user key)
Deployment	Vercel (Hobby, auto-deploy from `main`)
Icons	Lucide React
Font	Inter (Google Fonts) · Scheherazade New (Arabic text)

Architecture

Browser
  └── Next.js App Router (SSR/CSR hybrid)
        ├── /app                           # Pages (App Router)
        │   ├── /                          # Landing + LoggedIn home
        │   ├── /semestres                 # Semester/module browser
        │   ├── /quiz/[activityId]         # Quiz engine
        │   ├── /revision                  # Révision ciblée dashboard
        │   ├── /revision/[id]             # Focused quiz session
        │   ├── /stats                     # Progress dashboard
        │   ├── /profil                    # User profile
        │   ├── /settings                  # AI model + theme + data reset
        │   ├── /auth                      # Sign in / Sign up
        │   ├── /chatwithai                # AI Chat (streaming)
        │   ├── /bookmarks                 # Saved questions
        │   ├── /leaderboard               # Rankings
        │   ├── /activate                  # Activation key entry
        │   ├── /admin                     # Admin panel (seeding, users)
        │   └── /not-found                 # EKG flatline 404
        │
        ├── /api
        │   ├── /ai-explain                # GitHub Models streaming (maxDuration=60)
        │   ├── /chat                      # ChatWithAI streaming + searchQCM tool
        │   ├── /gh-models                 # Models catalog, cached 1h
        │   ├── /sync                      # Cron 02:00 UTC — DariQCM incremental sync
        │   ├── /scrape-expand             # POST {year:2-5} — seed odd semesters
        │   └── /scrape-even               # POST — seed even semesters (S2/S4/S6/S8/S10)
        │
        └── /components
            ├── layout/                    # AppShell, Sidebar, ThemeProvider
            ├── auth/                      # AuthProvider, forms
            ├── quiz/                      # QuizEngine, OptionCard, AIExplain
            └── ui/                        # Shared primitives

Supabase (PostgreSQL)
  ├── Auth (email/password, no verification)
  ├── RLS policies (user_answers, profiles, ai_explanations)
  └── Trigger: create_profile_on_signup()

Getting Started

Prerequisites

Node.js 20+
Bun (recommended) or npm
Supabase project
GitHub PAT with models:read permission (for AI explanations)

Installation

# Clone
git clone https://github.com/KNIGHTABDO/zeroqcm.git
cd zeroqcm

# Install dependencies
bun install

# Copy environment template
cp .env.example .env.local

# Fill in your env vars (see below), then:
bun dev

Open http://localhost:3000.

Environment Variables

# Supabase
NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key

# GitHub Models (server-side only — never exposed to client)
GITHUB_MODELS_TOKEN=ghp_your_token_with_models_read

# Cron secret (for seeding endpoints)
CRON_SECRET=your-secret

Security note: GITHUB_MODELS_TOKEN is server-side only. Never prefix it with NEXT_PUBLIC_. Vercel Edge Runtime cannot access sensitive-type env vars — use Node.js runtime for the AI route.

Project Structure

zeroqcm/
├── public/
│   ├── logo.jpg                    # ZeroQCM official logo
│   ├── favicon.ico                 # 16/32/48px ICO
│   ├── icon.png                    # 512×512 PNG
│   ├── icon-192.png                # 192×192 PWA icon
│   ├── apple-touch-icon.png        # 180×180 iOS
│   ├── site.webmanifest            # PWA manifest
│   └── images/                     # Landing hero images
│
├── src/
│   ├── app/                        # Next.js App Router pages
│   ├── components/                 # React components
│   ├── lib/
│   │   ├── supabase.ts             # Supabase client + helpers
│   │   └── utils.ts
│   └── types/                      # Shared TypeScript types
│
├── .env.example
├── next.config.ts
├── tailwind.config.ts
└── package.json

AI Integration

ZeroQCM uses GitHub Models for AI explanations — entirely server-side, no API key required from students.

How it works

Student taps an option → frontend sends { prompt, model } to /api/ai-explain
API route authenticates with GITHUB_MODELS_TOKEN (server-side env var on Vercel)
Stream response chunked back to client, rendered token-by-token
On success, explanation stored in ai_explanations (keyed by SHA256(prompt)) — all future requests for the same question hit cache instantly

Model whitelist

The API enforces a server-side model whitelist with gpt-4o-mini as fallback:

const ALLOWED_MODELS = [
  "gpt-4o-mini", "gpt-4o", "o3-mini", "o4-mini",
  "Meta-Llama-3.3-70B-Instruct", "Phi-4", "Phi-4-mini",
  "Mistral-Large-2", "Cohere-Command-R-Plus-08-2024",
];

Data Pipeline

All question data is sourced from DariQCM, the official Moroccan medical faculty QCM platform.

Sync architecture

DariQCM API
  │
  ├── /api/scrape-expand   POST {year:2-5}  → Odd semesters (S1,S3,S5,S7,S9)
  │   └── AES-256-GCM encrypted → decrypts → normalizes → upserts
  │
  ├── /api/scrape-even     POST             → Even semesters (S2,S4,S6,S8,S10)
  │   └── Direct /api/modules/{id}/questions → normalizes → upserts
  │
  └── /api/sync            Cron 02:00 UTC  → Incremental daily sync
        └── Fetches delta → upserts new questions

Deployment

ZeroQCM is deployed on Vercel with automatic deploys from the main branch.

Push to main → Vercel build → Deploy to zeroqcm.me

Critical Vercel settings

Setting	Value	Why
Runtime for `/api/ai-explain`	`nodejs` (not `edge`)	Edge Runtime can't read sensitive env vars
`maxDuration` on AI route	`60`	Prevents default 10s Hobby timeout from killing streams
`GITHUB_MODELS_TOKEN`	Encrypted env var	Server-side only, never exposed to browser

Roadmap

✅ Shipped (Feb–Mar 2026)

📜 Upcoming

MonQCM past-exam questions (30k+)
Push notifications for streak reminders
Offline mode (PWA service worker)
PDF export of bookmarked questions
Faculty-specific question filters

Contributing

Pull requests are welcome. For major changes, open an issue first.

git checkout -b feature/your-feature
# make changes
git commit -m "feat: description"
git push origin feature/your-feature

License

MIT — free to use, modify, and distribute.

Built with ❤️ for Moroccan medical students

zeroqcm.me · GitHub

Name		Name	Last commit message	Last commit date
Latest commit History 456 Commits
data		data
public		public
scripts		scripts
src		src
supabase/migrations		supabase/migrations
.env.example		.env.example
.env.local		.env.local
.gitignore		.gitignore
DATABASE.md		DATABASE.md
README.md		README.md
middleware.ts		middleware.ts
next.config.ts		next.config.ts
package.json		package.json
postcss.config.js		postcss.config.js
tailwind.config.ts		tailwind.config.ts
tsconfig.json		tsconfig.json
vercel.json		vercel.json

Folders and files

Latest commit

History

Repository files navigation

ZeroQCM

Table of Contents

Overview

Why ZeroQCM?

Features

🎯 Core Quiz Engine

🧠 AI Explanations

📊 Progress & Spaced Repetition

📚 Student Community

📋 Rich Content Rendering

🎨 Design System

🔐 Auth & Profiles

Database

Schema

Tech Stack

Architecture

Getting Started

Prerequisites

Installation

Environment Variables

Project Structure

AI Integration

How it works

Model whitelist

Data Pipeline

Sync architecture

Deployment

Critical Vercel settings

Roadmap

✅ Shipped (Feb–Mar 2026)

📜 Upcoming

Contributing

License

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages