EZ Quiz

Getting Started

Enter a topic in the Topic field, set Length and Difficulty.
Click Start to generate and begin the quiz, or open Options for more controls.

Generate vs Start

Start (default): generates → parses → starts the quiz.
Generate (Options → Quiz Editor open): fills the Editor and Mirror only; the quiz starts when you click Start.
Re‑using Generate clears the editor and creates a fresh set.

Options & Quiz Editor

Options: Timer, Theme, Question Types, and Defaults.
Quiz Editor: Editor (paste or load .txt), Mirror (raw lines), Copy prompts, Export .txt.
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; Auto‑start after generate (Start mode only).

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

Generate sends Topic, Length, Difficulty, and selected types to the AI.
If nothing returns, try again shortly (rate limits), use Demo Set, or paste lines into the editor.

What's New

Start vs Generate: Start runs the quiz; Generate fills Editor + Mirror.
Options panel: Timer, Theme, Types, and Quiz Editor tools in one place.
Quiz Editor: Editor, Mirror, Copy prompts, Export .txt.
Defaults: Save Count/Difficulty/Types; Reset defaults clears them.
Navigation polish: Equal-width fields on mobile; clearer focus.

FAQ

Q: What’s the difference between “Start” and “Generate”?: A: Generate fills the Editor and Mirror so you can review or edit. Start actually begins a quiz run — think Generate as “draft mode,” Start as “play mode.”
Q: Why is the Mirror empty?: A: The Mirror shows raw quiz lines (MC|, TF|, etc.). It stays blank until you Generate or paste lines into the Editor.
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 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 the Quiz Editor, you’ll find options to copy quiz lines for AI prompts or export them 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.

Parser 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

Beta Features Enable beta features and auto-redirect to /beta

When enabled, you'll automatically be redirected to the beta version of the app on future visits.

Version v3.3 Production build

v3.3

Stable AI fallback loop now ships to everyone.
All recent UI polish and cache busts are part of the main app.

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.14 and service worker cache to v123 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.