EZ Quiz

This source looks narrow for a 30-question quiz. EZ Quiz can still try, but some questions may feel repetitive. For more variety, add more study material or choose fewer questions.

Getting Started

Enter a topic in the Topic field, set Length and Difficulty.
Click Create Quiz to build the quiz. Start Quiz unlocks after a valid quiz is ready.

Create vs Start

Create Quiz: builds a quiz from your topic or study material.
Start Quiz: begins taking the ready quiz.
If a new build fails, the last valid quiz stays available.

Options & Quiz Editor

Options: Timer, Theme, Question Types, and Defaults.
Advanced / Manual quiz import: paste or load EZ Quiz formatted lines, then use Start Quiz after the quiz is valid.
Supported types: Multiple Choice (single/multiple), True/False, Yes/No, Matching.

Defaults

Save as default stores your Count, Difficulty, and Types for next time.
Use Reset defaults to clear saved generation defaults.

Timer & Settings

Stopwatch or Countdown (mm:ss) in Settings; preferences persist locally.
Optional: Require answer to advance; Start Quiz is a separate step after Create Quiz succeeds.

Taking Quizzes

Navigation: Enter/Right = Next; Backspace/Left = Previous.
Answers: MC (A–D or 1–4), True/False (T/F), Yes/No (Y/N).

Results & Retakes

Results show score, time, and Missed/All (Missed first by default).
Retake missed only: use the caret next to Retake.

AI Generation

Create sends Topic or Study Material, Length, Difficulty, and selected types to the AI.
Public quiz lengths are 5, 10, 15, 20, 30, and 50 questions.
Topic-only quizzes use smaller batches; larger study material is planned by source sections when possible.
Supported imports: PDF, DOCX, TXT, Markdown, HTML, CSV, JSON, RTF, and images.

What's New

Generation quality: Topic-only quizzes now build in smaller batches.
Source planning: Larger study material is split into useful sections before generation.
Cleaner question wording: Questions avoid phrases like “according to the notes.”
Import formats: PDF, DOCX, TXT, Markdown, HTML, CSV, JSON, RTF, and images.
Quiz size: Public quiz lengths now include 30 and 50 questions.

FAQ

Q: What’s the difference between “Create Quiz” and “Start Quiz”?: A: Create Quiz builds a valid quiz. Start Quiz begins taking the ready quiz.
Q: Why is the Mirror empty?: A: The Mirror is an advanced view for EZ Quiz formatted lines. It stays blank until a quiz is created or manual lines are loaded.
Q: Can I edit the quiz before starting?: A: Yes. Use the Editor to change or add your own questions. When you’re ready, click Start Quiz to run the version you’ve prepared.
Q: What are the Retake options?: A: Retake All repeats the full quiz. The caret menu lets you retake only the questions you missed, or shuffle everything for a fresh run.
Q: How do I change settings like timer or theme?: A: Open the ⚙ Settings menu. You can adjust timer length, appearance theme, and reset to defaults at any time (except while a quiz is running).
Q: Where can I export or copy my quiz?: A: In Advanced / Manual quiz import, you’ll find options to copy or export EZ Quiz formatted lines as a .txt file.
Q: What happens if the app updates mid‑quiz?: A: Nothing changes until you finish or exit. Updates only apply once you refresh or start a new quiz, so your current run is never interrupted.
Q: How does feedback work?: A: Feedback is sent securely through a server function. Messages are sanitized, rate‑limited, and delivered to the maintainer’s inbox.

Manual Format Reference

MC|Question?|A) Opt1;B) Opt2;C) Opt3;D) Opt4|A
TF|Statement.|T
YN|Question?|Y
MT|Prompt.|1) L1;2) L2|A) R1;B) R2|1-A,2-B

Tip: For multiple answers, separate with commas (e.g., A,C).

Use the exact delimiters shown: pipes |, semicolons ;, and labels like A) or 1).

Timer Enable timer Countdown mode Duration (mm:ss)

Appearance Dark Light System

Quiz Editor Always show the Quiz Editor panel

Version v3.6.0 Production build

v3.6.0

Generation now shows true question progress, preserves ready questions when stopped, and clearly reports partial results.
Topic-only quizzes now build in smaller batches while preserving the requested count.
Larger study material is planned in sections, with cleaner question wording.
Public quiz lengths include 30 and 50 questions.
Imports support PDF, DOCX, TXT, Markdown, HTML, CSV, JSON, RTF, and images.

v1.5.0-beta.12

Explain (beta): localized toast near result items; inline block removed.
Topic input: unified control with a single soft focus border; hover/autofill no longer cause double highlights.
Tests: jsdom environment and resilient DOM parsing; header‑byte tests use Node Blob.

v1.5.0-beta.11

Results: continuous score bar, mobile overflow fixes, subtle transitions.
Generator: mobile stack layout refined; increased vertical spacing; Difficulty given more width.
Primary button: Start by default; Generate when QE open; flips back to Start after generation.
Explain (beta): on-demand result explanations now load from the lazy explanation endpoint.

v1.5.0-beta.9

Serverless fallback: AI calls now roll through /.netlify/functions/generate-quiz, /api/generate, and the default Netlify domain so missing rewrites or proxies no longer break Start/Generate.
Cache bust: bumped asset query strings to v1.5.17 and service worker cache to v125 so every client grabs the fix immediately.
AI fix: refreshed the Gemini model so Generate and Start deliver quizzes again without extra setup.
Previous polish retained: softened surfaces, wide-phone toolbar, and consistent spacing from beta.7 remain.

v1.5.0-beta.8

Start/Generate hotfix: AI calls hit /.netlify/functions/generate-quiz first, keeping production alive when /api/generate rewrites vanish.
Cache bust: bumped asset query strings to v1.5.13 and service worker cache to v122 for immediate delivery.
Previous polish retained: softened surfaces, wide-phone toolbar, and consistent spacing from beta.7 remain.

v1.5.0-beta.7

Softer surfaces: inputs, cards, and chips now use muted 1px borders and a gentle blue-violet focus ring—no more neon glow.
Generator breathing room: toolbar flips to a spacious two-column grid on wide phones (≈430–720px) so controls stop crowding each other.
Consistent spacing: section labels, results cards, and modal groups pick up the same relaxed gaps and radius tokens.
Deployment: cache-busted assets to v1.5.12 with service worker cache v121 for immediate delivery.

v1.3.0-beta.0

Interactive Editor (beta): opt‑in, card‑based authoring for MC/TF/YN that stays in sync with the raw Editor/Mirror (enable in the Quiz Editor).
Removed the gradient backdrop behind floating buttons; kept subtle shadows.
Added Reset App (clears caches + unregisters service workers).
Added URL reset: ?clear=1 or #clear-cache for stuck devices.
Bumped asset versions and service worker cache for reliable updates.

v1.2.0-beta.4

Retake button always runs the full quiz; caret offers Missed only.
Footer version is clickable — now opens this modal.
Service worker cache bumped for offline freshness.

Effective: 17 September 2025

EZ Quiz runs primarily on your device. We avoid collecting personal data and keep the experience self-contained whenever possible.

What We Don’t Collect

No accounts, analytics scripts, or advertising trackers.
No storage of your quiz content on our servers.

Stored Locally

The app may store theme or timer preferences and the most recent quiz in your browser’s storage so you can pick up where you left off.

Serverless Calls

Optional AI generation and feedback submission use Netlify Functions. Requests include only the information needed to fulfil them. Third-party providers apply their own policies.

Your Choices

Use the Reset App button or ?clear=1 to clear cached data.
Skip AI generation entirely—the editor works offline.
Contact us via the feedback panel for questions or requests.

Effective: 17 September 2025

By using EZ Quiz you agree to these terms and to the privacy policy. If you disagree, please refrain from using the app.

Service

The app delivers a browser-based quiz experience that can run offline. Optional AI generation may invoke third-party services.

License

You receive a personal, non-transferable license to use the app. Please do not reverse-engineer or redistribute it outside of what’s permitted by the project’s open-source license.

Your Content

You are responsible for the questions or text you input.
Only submit content you have rights to share.
Do not upload or generate unlawful or harmful material.

Liability

The app is provided “as-is” without warranties. We are not liable for damages arising from use of the app.

Welcome to EZ Quiz 3.6.0!

Quiz

Results