---
title: NCLEX Practice Question Generator
emoji: 📋
colorFrom: purple
colorTo: indigo
sdk: streamlit
sdk_version: 1.32.0
app_file: streamlit_app.py
pinned: false
license: mit
---
# 📋 NCLEX Practice Question Generator
**Clinically accurate NCLEX-style questions · Full rationales · Unlimited dosage calculations**
[](https://huggingface.co/spaces/NurseCitizenDeveloper/nclex-prep)
[](https://github.com/Clinical-Quality-Artifical-Intelligence/nclex-prep)
[](LICENSE)
[](https://www.ncsbn.org/nclex-rn)
*No login · No API key · No cost · Built by a nurse, for nurses*
---
## Overview
The **NCLEX Practice Question Generator** provides student nurses with high-quality, evidence-based practice questions aligned to the **2023 NCLEX-RN Test Plan** (NCSBN). Every question includes a detailed clinical rationale — teaching students not just the correct answer, but the critical thinking process behind it.
Dosage calculation questions are dynamically generated, providing unlimited unique math practice so students never memorise the same problem twice.
---
## Features
### 🎯 Practice Quiz
- **30+ high-quality questions** across all NCLEX Client Needs categories
- **Multiple Choice (MCQ)** — single best answer format
- **Select All That Apply (SATA)** — the most challenging NCLEX question type
- Filter by **category**, **difficulty**, and **question type**
- Instant answer reveal with detailed **clinical rationale**
### 💉 Dosage Calculations
- **Dynamically generated** — unlimited unique problems, never the same set twice
- Five question types:
- Oral tablet calculations
- IV infusion rate (mL/hr)
- Manual drip rate (gtt/min)
- Weight-based IV infusions (mcg/kg/min)
- Paediatric oral liquid dosing
- Step-by-step solution shown in the rationale
### 📊 Results & Performance Tracking
- Overall score and performance band
- **Category breakdown** — identify weak areas by NCLEX domain
- **Difficulty breakdown** — performance across beginner / intermediate / advanced
### 🔁 Wrong Answer Review
- Every missed question available for focused review
- NCLEX framework category shown for each question
- Rationale emphasised to build clinical reasoning
---
## NCLEX Client Needs Categories Covered
| Category | Sub-categories |
|----------|---------------|
| **Safe & Effective Care Environment** | Management of Care · Safety & Infection Control |
| **Health Promotion & Maintenance** | Growth & Development · Preventive Care |
| **Psychosocial Integrity** | Mental Health · Therapeutic Communication |
| **Physiological Integrity** | Basic Care · Pharmacology · Risk Reduction · Physiological Adaptation |
---
## Question Types
| Type | Description | NCLEX Relevance |
|------|-------------|-----------------|
| MCQ | Single best answer from 4 options | ~50% of NCLEX-RN |
| SATA | Select all correct options from 5–6 | ~20% of NCLEX-RN |
| Calculation | Dosage math with step-by-step workings | ~10% of NCLEX-RN |
---
## Tech Stack
| Layer | Technology |
|-------|-----------|
| Frontend | [Streamlit](https://streamlit.io/) (Python) |
| Question bank | Curated clinical question library (Python data structures) |
| Calc generator | Dynamic random question generation (no LLM required) |
| Hosting | [Hugging Face Spaces](https://huggingface.co/spaces) — free CPU tier |
| CI/CD | GitHub Actions → auto-deploy on push |
> **No API keys. No paid services. Fully open-source.**
---
## Local Development
```bash
git clone https://github.com/Clinical-Quality-Artifical-Intelligence/nclex-prep.git
cd nclex-prep
pip install -r requirements.txt
streamlit run streamlit_app.py
```
Requirements: Python 3.10+ · `streamlit` · `requests`
---
## About — Nursing Citizen Development
Part of the **Nursing Citizen Development** initiative — clinicians building the tools their profession needs.
**Related tools:**
- [EBP Research Tool](https://huggingface.co/spaces/NurseCitizenDeveloper/nursing-ebp-tool) — PubMed search with nursing summaries & APA citations
- [Drug Card Generator](https://huggingface.co/spaces/NurseCitizenDeveloper/nursing-drug-cards) — Instant FDA drug reference cards
---
## Disclaimer
For educational purposes only. Questions are designed to simulate NCLEX-style critical thinking but do not represent actual NCLEX examination items. Always study from NCSBN-approved resources and consult your nursing programme's curriculum.
---
## License
[MIT](LICENSE) © Nursing Citizen Development / Clinical Quality Artificial Intelligence
---