https://github.com/refloow/exam-quiz-test
❤️ An open-source, browser-based quiz with configurable settings via one HTML file. Supports single/multiple-choice questions, dark/light mode, randomized questions & answers, instant mistake feedback, percentage scoring, and mobile scalability. Includes a tool to convert human-readable questions to JSON
https://github.com/refloow/exam-quiz-test
exam exam-builder exam-practice exam-quiz-tester exam-simulator multiple-choice practice-exam-platform quiz quiz-app quiz-creator quiz-generator quiz-simulator quiz-software random-questions-quiz randomized-exam-generator single-choice test test-creator test-simulator
Last synced: 4 months ago
JSON representation
❤️ An open-source, browser-based quiz with configurable settings via one HTML file. Supports single/multiple-choice questions, dark/light mode, randomized questions & answers, instant mistake feedback, percentage scoring, and mobile scalability. Includes a tool to convert human-readable questions to JSON
- Host: GitHub
- URL: https://github.com/refloow/exam-quiz-test
- Owner: Refloow
- License: mit
- Created: 2025-03-18T18:20:02.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-10-08T01:01:21.000Z (8 months ago)
- Last Synced: 2025-10-08T03:07:49.847Z (8 months ago)
- Topics: exam, exam-builder, exam-practice, exam-quiz-tester, exam-simulator, multiple-choice, practice-exam-platform, quiz, quiz-app, quiz-creator, quiz-generator, quiz-simulator, quiz-software, random-questions-quiz, randomized-exam-generator, single-choice, test, test-creator, test-simulator
- Language: HTML
- Homepage: https://discord.gg/4enDY8yhuS
- Size: 80.1 KB
- Stars: 3
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Citation: CITATION.cff
Awesome Lists containing this project
README
# Exam-Quiz-Test Platform
A lightweight, browser-based quiz platform that allows users to create and customize tests by simply editing one HTML file. It includes a tool to convert human-readable questions into JSON format for easy integration. The application is **fully open-source** under the **MIT license**.
# DISCORD Server:
On the server anyone can feel free to ask questions, engage in the comunity and discover other free open source software i build
**https://discord.gg/4enDY8yhuS**
## Features
✅ **Customizable Questions & Timer**
- Edit a single HTML file to set the dataset of questions and test duration.
✅ **Single & Multiple Choice Questions**
- Supports both **single-choice** and **multi-choice** question formats.
✅ **Dark Mode & Light Mode**
✅ **Randomized Question & Answer Order**
✅ **Instant Feedback on Mistakes**
✅ **Accurate Scoring System**
- **Single-choice questions:** 100% or 0% per question.
- **Multiple-choice questions:**
- Correct partial selections get **partial percentage**.
- Any wrong selection results in **0% for that question**.
✅ **Total Score Calculation**
✅ **No Installation Required**
- The quiz runs **directly in the browser**—no backend or server required.
✅ **Separate Question Converter Tool**
- Convert human-readable question formats into JSON format for easy integration.
✅ Supports multiline questions using ``` and ```
✅ Properly extracts code blocks (```)
✅ Mobile scalable and friendly UI
---
## Usage Instructions
### 1️⃣ **Editing Questions & Timer**
Modify the provided HTML file to:
- Set the total **quiz time**.
- Input your **questions and answers**.
```
/******************************************************
* 1) CONFIGURATION & QUESTION DATA (inlined)
******************************************************/
const config = {
// total time in seconds
totalTime: 90,
// how many questions to pick
questionsToPick: 5
};
```
### 2️⃣ **Question Format (Human-Readable)**
This is how to prepare your questions before using the conversion tool to add them to the test
> Number in front indicates start of an question
> Answers need to be below the question
> Questions should not have empty lines below each other in prepared data
> • for answers is optional, answers can be added without it by being below the question. Program will ignore • if its present it. Everything in the lines below the question is read as answer, this is useful if questions are copied from a PDF
> Everything selected with an * next to it is marked as a correct answer
> To make multichoice question just add * to more answers
> To make a multilined question use ``` ``` to wrap the question around
> For code containing multilined questions to display in a codeblock use 3 ` on the left and right side of the code
EXAMPLES OF PREPARED DATA FOR CONVERSION:
```txt
1. Choose the right answer to 2+2
• 1
• 2
• 4 *
• 5
2. What of the following are fruits?
• apple *
• banana *
• melon *
• cucumber
3. Multilined question like this
can contain a lot of stuff like
asking about how was your day
• good *
• bad
• i dont know
• i dont wanna say
4. What does the following code do
``` function add(a, b) { return a + b; } ```
Select the right answer from below:
• It subtracts
• It adds *
• It multiplies
• It divides
```
### 3️⃣ **JSON Converted Format**
```
const questionPool = [
{
"question": "Choose the right answer to 2+2",
"options": [
"1",
"2",
"4",
"5"
],
"correctAnswers": [
2
],
"type": "single"
},
{
"question": "What of the following are fruits?",
"options": [
"apple",
"banana",
"melon",
"cucumber"
],
"correctAnswers": [
0,
1,
2
],
"type": "multiple"
},
{
"question": " Multilined question like this\ncan contain a lot of stuff like\nasking about how was your day",
"options": [
"good",
"bad",
"i dont know",
"i dont wanna say"
],
"correctAnswers": [
0
],
"type": "single"
},
{
"question": " What does the following code do\n``` function add(a, b) { return a + b; } ```\nSelect the right answer from below:\n",
"options": [
"It subtracts",
"It adds",
"It multiplies",
"It divides"
],
"correctAnswers": [
1
],
"type": "single"
}
// add more questions if you want ...
];
```
### 4️⃣ **Running the Quiz**
Simply open the HTML file in any modern web browser. The quiz will start immediately.
### 5️⃣ **Using the Question Converter Tool**
Navigate to the **Question Converter Page**, paste the human-readable format, and generate JSON to integrate into the quiz.
---
## Installation (Optional for Local Development)
1. Clone the repository:
```sh
git clone https://github.com/Refloow/Exam-Quiz-Test.git
```
2. Open `index.html` in your browser.
## License
This project is **open-source** under the **MIT License**. Feel free to use, modify, and distribute it!
## Contributing
We welcome contributions! Feel free to submit pull requests or report issues.
Enjoy building your quizzes! 🚀