gtsinnovation/caregiver-quiz

Family Care Workforce for Liberia # Caregiver Knowledge Check An interactive web quiz built with Next.js 15 covering all 50 questions from the **Family Care Workforce Solutions Caregiver Handbook** (Module 19 — Staff Knowledge Assessment Quiz). Companion asset: an 18-scene narrated training video (Oprah Winfrey voice) covering Modules 1–18 of the handbook. See `docs/narration-script.md` for the full script and `docs/final-exam.md` for the exam question bank in plain-text form. ## Features - 50 multiple-choice questions, one at a time, with a progress bar - Instant scoring against the handbook's official score-interpretation bands: | Score | Result | Next Steps | |---|---|---| | 45–50 | Excellent | Ready to care with confidence | | 38–44 | Good | Review missed questions before first shift | | 30–37 | Needs Review | Revisit relevant handbook modules | | 25–29 | Requires Coaching | Supervisor schedules 1:1 coaching | | Below 25 | Mandatory Retraining | Repeat the full training program | - Full answer review after submission (correct answers highlighted) - Retake button — no limit on attempts - Built with Next.js 15 (App Router), TypeScript, Tailwind CSS, shadcn/ui, and Framer Motion ## Getting Started ```bash npm install npm run dev ``` Open localhost to view the quiz. ## Project Structure ``` app/ page.tsx # Renders the QuizApp layout.tsx # Root layout components/ quiz-app.tsx # Quiz state machine, all screens (intro/quiz/results) ui/ # shadcn/ui primitives lib/ questions.ts # All 50 questions, options, and correct answers utils.ts # cn() helper docs/ narration-script.md # Full 18-scene Oprah-style video narration script final-exam.md # All 50 exam questions in Q&A text format ``` ## Editing the Question Bank All questions live in `lib/questions.ts` as a typed array: ```ts export interface Question { q: string; options: string[]; answer: number; // index of the correct option } ``` Add, remove, or edit qu …