Exam Software

Minimal local-first exam software built with Vite, React, and TypeScript.

The public repo contains the software only. It does not include bundled exam questions, proprietary PDFs, or derived exam datasets. You import your own validated exam packs locally.

What it does

• Runs exams in exam mode with a timer
• Runs practice mode with no timer and answer reveal
• Saves sessions locally so you can reopen them later
• Lets you flag questions and retake only flagged questions
• Lets you review currently incorrect questions mid-session
• Lets you save an optional checkpoint before switching into a filtered review flow
• Supports light mode and dark mode with a strict black/white interface

Run locally

cd app
npm install
npm run dev

Validate the app

cd app
npm run lint
npm test
npm run build

Importing exam content

1. Convert your source material into the normalized question JSON described in docs/ingestion-pipeline.md.
2. Build an app-compatible pack with scripts/build_exam_pack.py.
3. Validate the pack with scripts/validate_exam_pack.py.
4. Import the resulting .exam.json file through the app UI.

Repo safety

• Private source PDFs and extracted datasets are ignored by the repo.
• app/public/exams/catalog.json is intentionally empty in the public repo.
• If you keep local exam packs next to the app, do not remove the .gitignore rules unless you intend to publish them.