OpenQuiz — Quiz Builder by Self Study

📚 0 Quizzes ❓ 0 Questions

🔍

How do you want to create your quiz?

Choose your preferred method below — you can switch anytime

✏️

Create Manually

Use the form builder to add questions one by one, pick styles, and preview

Form Builder

📥

Create from JSON

Paste or upload a JSON file — perfect for AI-generated or pre-made quizzes

JSON Import

📋 Info

❓ Questions

🎨 Style

📥 Import JSON

🤖 AI

👁 Preview

Quiz Details

Quiz Title *

Subject (optional)

Chapter / Topic (optional)

Sub-topic (optional)

Description

Timer per Question (seconds)

Author / Creator

🚀 Quick Start

OpenQuiz lets you create beautiful MCQ quizzes in three ways:

✏️

Manual Builder
Fill in the form, add questions one-by-one

📥

Paste JSON
Paste a valid JSON object directly

🤖

AI-Generated
Give an AI the prompt below, paste result

📄 JSON Format — Blank Template

Copy this blank template and fill in your own data.

{ "title": "Your Quiz Title", "subject": "Subject Name", "chapter": "Chapter Name", "topic": "Topic Name", "description": "Short description (optional)", "author": "Your Name", "timerSeconds": 30, "icon": "📝", "colorScheme": "purple", "questions": [ { "question": "Your question text here?", "options": ["Option A", "Option B", "Option C", "Option D"], "correct": 0, "explanation": "Explanation shown after answering (optional)", "difficulty": "easy", "tags": ["tag1", "tag2"] } ] }

🔢 Question Answer Indexing Guide Important

Each question's correct field uses 0-based indexing. This means the first option has index 0, not 1.

Index Value	Maps To	Example
0	Option A (first)	`"correct": 0` = first option is correct
1	Option B (second)	`"correct": 1` = second option is correct
2	Option C (third)	`"correct": 2` = third option is correct
3	Option D (fourth)	`"correct": 3` = fourth option is correct

💡 Tip Always ensure your options array has exactly 4 strings. The index must be between 0 and 3. Invalid indices will default to 0 (Option A).

🎨 Applicable Themes AI-Friendly

OpenQuiz supports 7 color schemes plus a light mode. Set the colorScheme field in your JSON to one of these values:

Violet

Violet"purple"

Ocean

Ocean"ocean"

Sunset

Sunset"sunset"

Forest

Forest"forest"

Rose

Rose"rose"

Gold

Gold"gold"

Arctic

Arctic"arctic"

💡 Tip Users can also enable Light Mode from Settings — this inverts the background/foreground while keeping the accent color scheme.

📊 JSON Fields Reference AI-Friendly

Complete reference of all supported fields in the OpenQuiz JSON format. Fields marked Required must be present for a valid quiz.

Field	Type	Status	Description & Validation
title	string	Required	Quiz title shown on start screen (max 100 chars)
subject	string	Optional	Subject area (e.g. "Physics")
chapter	string	Optional	Chapter name (e.g. "Chapter 3")
topic	string	Optional	Specific sub-topic
description	string	Optional	Short description shown under title (max 200 chars)
author	string	Optional	Creator's name shown in metadata
timerSeconds	number	Optional	Seconds per question (default: 30, min: 5, max: 300)
icon	string	Optional	Single emoji icon (e.g. "🔬", "⚡")
colorScheme	string	Optional	One of: purple, ocean, sunset, forest, rose, gold, arctic (default: purple)
questions	array	Required	Array of question objects (see below). Must have at least 1 item.
questions[].question	string	Required	The question text. Supports KaTeX math with $$...$$
questions[].options	string[]	Required	Array of exactly 4 answer options (strings). Will be shown as A/B/C/D.
questions[].correct	number	Required	0-based index of correct option (0=A, 1=B, 2=C, 3=D). Must be 0–3.
questions[].explanation	string	Optional	Educational explanation shown after answering (recommended for learning)
questions[].difficulty	string	Optional	One of: "easy", "medium", "hard" (default: "easy")
questions[].tags	string[]	Optional	Category tags for the question (e.g. ["physics","newton"])

🤖 AI Prompt — Generate Quiz with Any AI AI-Friendly

Copy the prompt below and paste it into ChatGPT, Claude, Gemini, DeepSeek, or any AI. Replace the placeholders and it will generate a ready-to-import JSON. Always verify the output before importing.

Generate an MCQ quiz in JSON format for the OpenQuiz app. Topic: [YOUR TOPIC HERE] Number of questions: [NUMBER, e.g. 10] Difficulty: [easy / medium / hard / mixed] Language: [e.g. English / Bengali / Hindi] Question style: [factual / conceptual / application-based / mixed] Return ONLY a valid JSON object (no markdown, no explanation, no backticks) with exactly this structure: { "title": "Quiz title", "subject": "Subject", "chapter": "Chapter", "topic": "Topic", "description": "Brief description", "author": "AI", "timerSeconds": 30, "icon": "appropriate single emoji", "colorScheme": "purple", "questions": [ { "question": "Question text?", "options": ["A option", "B option", "C option", "D option"], "correct": 0, "explanation": "Why this answer is correct — be educational", "difficulty": "easy", "tags": ["relevant", "tags"] } ] } RULES (strict — follow exactly): 1. options array must have exactly 4 strings, no more no less 2. correct is a 0-based index: 0=A, 1=B, 2=C, 3=D 3. explanation should be educational (1-2 sentences), not just "Correct answer" 4. colorScheme must be one of: purple, ocean, sunset, forest, rose, gold, arctic 5. icon should be a relevant single emoji (e.g., 🔬 for science, 📚 for general) 6. Output ONLY the JSON — no markdown blocks, no code fences, no commentary 7. Use proper JSON syntax — double quotes, no trailing commas 8. Distribute difficulty evenly if set to "mixed"

📋 AI Compatibility Checklist

Before sending your prompt to an AI, make sure:

✅ Clear topic — specify exactly what the quiz should cover ✅ Exact count — tell the AI how many questions you need ✅ Strict format — emphasize "no markdown, just JSON" ✅ 4 options only — enforce exactly 4 options per question ✅ 0-based index — remind the AI about correct field indexing ✅ Educational explanations — request meaningful explanations ✅ Theme variety — try different colorScheme values for branding

📌 Example Quiz JSON

{ "title": "Physics: Laws of Motion", "subject": "Physics", "chapter": "Chapter 3", "topic": "Newton's Laws", "description": "Test your knowledge of classical mechanics", "author": "Self Study", "timerSeconds": 25, "icon": "⚡", "colorScheme": "ocean", "questions": [ { "question": "Newton's First Law is also known as the Law of?", "options": ["Acceleration", "Inertia", "Gravitation", "Motion"], "correct": 1, "explanation": "Newton's First Law states that an object stays at rest or in motion unless acted upon by a force — this property is called Inertia.", "difficulty": "easy", "tags": ["newton", "inertia"] }, { "question": "If F = 10N and m = 2kg, what is the acceleration?", "options": ["2 m/s²", "5 m/s²", "8 m/s²", "20 m/s²"], "correct": 1, "explanation": "Using F = ma, a = F/m = 10/2 = 5 m/s²", "difficulty": "medium", "tags": ["formula", "acceleration"] } ] }

🔗 Links

🌐 Self Study Website 💻 Source Code on GitHub