{"id":27098660,"url":"https://github.com/refloow/exam-quiz-test","last_synced_at":"2026-01-20T14:33:16.728Z","repository":{"id":283141231,"uuid":"950817514","full_name":"Refloow/Exam-Quiz-Test","owner":"Refloow","description":"❤️ An open-source, browser-based quiz with configurable settings via one HTML file. Supports single/multiple-choice questions, dark/light mode, randomized questions \u0026 answers, instant mistake feedback, percentage scoring, and mobile scalability. Includes a tool to convert human-readable questions to JSON","archived":false,"fork":false,"pushed_at":"2025-10-08T01:01:21.000Z","size":82,"stargazers_count":3,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-08T03:07:49.847Z","etag":null,"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"],"latest_commit_sha":null,"homepage":"https://discord.gg/4enDY8yhuS","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Refloow.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-03-18T18:20:02.000Z","updated_at":"2025-10-08T01:01:24.000Z","dependencies_parsed_at":"2025-10-08T03:03:43.123Z","dependency_job_id":"ed635fcd-b848-4aba-b5bc-ca09766e27e7","html_url":"https://github.com/Refloow/Exam-Quiz-Test","commit_stats":null,"previous_names":["refloow/exam-quiz-test"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Refloow/Exam-Quiz-Test","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Refloow%2FExam-Quiz-Test","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Refloow%2FExam-Quiz-Test/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Refloow%2FExam-Quiz-Test/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Refloow%2FExam-Quiz-Test/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Refloow","download_url":"https://codeload.github.com/Refloow/Exam-Quiz-Test/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Refloow%2FExam-Quiz-Test/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28604917,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T12:01:53.233Z","status":"ssl_error","status_checked_at":"2026-01-20T12:01:46.545Z","response_time":117,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["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"],"created_at":"2025-04-06T11:51:16.570Z","updated_at":"2026-01-20T14:33:16.721Z","avatar_url":"https://github.com/Refloow.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Exam-Quiz-Test Platform\n\nA 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**.\n\n\n![image](https://github.com/user-attachments/assets/3ddddb5a-9f9b-4915-a84b-52cb98bbfdd7)\n\n# DISCORD Server:\nOn the server anyone can feel free to ask questions, engage in the comunity and discover other free open source software i build \n**https://discord.gg/4enDY8yhuS**\n\n## Features\n\n✅ **Customizable Questions \u0026 Timer**\n- Edit a single HTML file to set the dataset of questions and test duration.\n\n✅ **Single \u0026 Multiple Choice Questions**\n- Supports both **single-choice** and **multi-choice** question formats.\n\n✅ **Dark Mode \u0026 Light Mode**\n\n✅ **Randomized Question \u0026 Answer Order**\n\n✅ **Instant Feedback on Mistakes**\n\n✅ **Accurate Scoring System**\n- **Single-choice questions:** 100% or 0% per question.\n- **Multiple-choice questions:**\n  - Correct partial selections get **partial percentage**.\n  - Any wrong selection results in **0% for that question**.\n\n✅ **Total Score Calculation**\n\n✅ **No Installation Required**\n- The quiz runs **directly in the browser**—no backend or server required.\n  \n✅ **Separate Question Converter Tool**\n- Convert human-readable question formats into JSON format for easy integration.\n  \n✅ Supports multiline questions using ```\u003cq\u003e and \u003c/q\u003e```\n\n✅ Properly extracts code blocks (```)\n\n✅ Mobile scalable and friendly UI\n\n---\n\n## Usage Instructions\n\n### 1️⃣ **Editing Questions \u0026 Timer**\nModify the provided HTML file to:\n- Set the total **quiz time**.\n- Input your **questions and answers**.\n\n  ```\n  /******************************************************\n     * 1) CONFIGURATION \u0026 QUESTION DATA (inlined)\n  ******************************************************/\n    const config = {\n      // total time in seconds\n      totalTime: 90,\n      // how many questions to pick\n      questionsToPick: 5\n    };\n  ```\n\n### 2️⃣ **Question Format (Human-Readable)**\nThis is how to prepare your questions before using the conversion tool to add them to the test\n\n\u003e Number in front indicates start of an question\n\n\u003e Answers need to be below the question\n\n\u003e Questions should not have empty lines below each other in prepared data \n\n\u003e • 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\n\n\u003e Everything selected with an * next to it is marked as a correct answer\n\n\u003e To make multichoice question just add * to more answers\n\n\u003e To make a multilined question use ```\u003cq\u003e \u003c/q\u003e``` to wrap the question around\n\n\u003e For code containing multilined questions to display in a codeblock use 3 ` on the left and right side of the code\n\nEXAMPLES OF PREPARED DATA FOR CONVERSION:\n\n```txt\n1. Choose the right answer to 2+2\n• 1\n• 2\n• 4 *\n• 5\n2. What of the following are fruits?\n• apple *\n• banana *\n• melon *\n• cucumber\n3. \u003cq\u003e Multilined question like this\ncan contain a lot of stuff like\nasking about how was your day \u003c/q\u003e\n• good *  \n• bad\n• i dont know\n• i dont wanna say \n4. \u003cq\u003e What does the following code do\n\n``` function add(a, b) { return a + b; } ```\n\nSelect the right answer from below:\n\u003c/q\u003e\n• It subtracts  \n• It adds *  \n• It multiplies  \n• It divides  \n\n\n\n```\n\n### 3️⃣ **JSON Converted Format**\n```\n   const questionPool = [\n  {\n    \"question\": \"Choose the right answer to 2+2\",\n    \"options\": [\n      \"1\",\n      \"2\",\n      \"4\",\n      \"5\"\n    ],\n    \"correctAnswers\": [\n      2\n    ],\n    \"type\": \"single\"\n  },\n  {\n    \"question\": \"What of the following are fruits?\",\n    \"options\": [\n      \"apple\",\n      \"banana\",\n      \"melon\",\n      \"cucumber\"\n    ],\n    \"correctAnswers\": [\n      0,\n      1,\n      2\n    ],\n    \"type\": \"multiple\"\n  },\n  {\n    \"question\": \" Multilined question like this\\ncan contain a lot of stuff like\\nasking about how was your day\",\n    \"options\": [\n      \"good\",\n      \"bad\",\n      \"i dont know\",\n      \"i dont wanna say\"\n    ],\n    \"correctAnswers\": [\n      0\n    ],\n    \"type\": \"single\"\n  },\n  {\n    \"question\": \" What does the following code do\\n``` function add(a, b) { return a + b; } ```\\nSelect the right answer from below:\\n\",\n    \"options\": [\n      \"It subtracts\",\n      \"It adds\",\n      \"It multiplies\",\n      \"It divides\"\n    ],\n    \"correctAnswers\": [\n      1\n    ],\n    \"type\": \"single\"\n  }\n      // add more questions if you want ...\n    ];\n```\n\n### 4️⃣ **Running the Quiz**\nSimply open the HTML file in any modern web browser. The quiz will start immediately.\n\n### 5️⃣ **Using the Question Converter Tool**\nNavigate to the **Question Converter Page**, paste the human-readable format, and generate JSON to integrate into the quiz.\n\n![image](https://github.com/user-attachments/assets/5b66c834-8760-46f0-a613-127d752f15b5)\n\n\n---\n\n## Installation (Optional for Local Development)\n1. Clone the repository:\n   ```sh\n   git clone https://github.com/Refloow/Exam-Quiz-Test.git\n   ```\n2. Open `index.html` in your browser.\n\n\n## License\n\nThis project is **open-source** under the **MIT License**. Feel free to use, modify, and distribute it!\n\n\n## Contributing\nWe welcome contributions! Feel free to submit pull requests or report issues.\n\n\nEnjoy building your quizzes! 🚀\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frefloow%2Fexam-quiz-test","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frefloow%2Fexam-quiz-test","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frefloow%2Fexam-quiz-test/lists"}