Quiz Wiz
Turn a plain-English quiz idea into a fully working, playable web-based quiz game through a multi-step AI pipeline that designs, generates data, and implements the code.
Quiz Wiz Documentation
# ๐ง Quiz Wiz
**Turn any idea into a playable quiz game โ no coding required.**
Quiz Wiz uses the power of AI to take a simple description of a quiz topic and transform it into a fully working,
browser-based quiz game. Just describe what you want, click a few buttons, and watch your quiz come to life.
---
## โจ What Can Quiz Wiz Do For You?
Ever wanted to create a fun quiz for your team, classroom, event, or just for laughs โ but didn't know where to start?
Quiz Wiz handles everything:
- ๐ฏ **Designs** the structure and rules of your quiz automatically
- ๐ **Writes** all the questions, answers, and explanations for you
- ๐ฎ **Builds** a polished, playable web app โ ready to share
- ๐งช **Tests** the game to catch any issues before you do
- ๐ **Reviews** the results and flags anything that needs fixing
- โป๏ธ **Refines** the game based on your feedback, as many times as you like
No design skills. No coding. No fuss.
---
## ๐บ๏ธ How It Works โ The Six Steps
Quiz Wiz walks you through a simple pipeline, one step at a time. Each step builds on the last.
| Step | What Happens |
|------|-------------|
| **โ Quiz Idea** | You describe your quiz in plain English |
| **โก Design** | AI designs the structure and game flow |
| **โข Game Data** | AI writes all the questions and answers |
| **โฃ Build Code** | AI assembles a working, playable web app |
| **โค Test** | The game is automatically run and checked |
| **โฅ Review** | AI reads the test results and notes any issues |
| **โฆ Update** | You give feedback; AI applies your changes |
---
## ๐ Getting Started
1. **Open Quiz Wiz** using your session link.
2. **Choose your AI models** at the top โ the defaults work great if you're not sure.
3. **Write your quiz idea** in the *Quiz Idea* box. A sentence or two is enough to get started!
4. Hit **๐พ Save Idea**, then work through each step by clicking the button in each card.
5. When the **โถ๏ธ Open Game** button lights up, your quiz is ready to play!
That's it. The whole process typically takes just a few minutes.
---
## ๐ก Writing a Great Quiz Idea
The more detail you give, the better your quiz will be. Try to mention:
- **The topic** โ What is the quiz about?
- **Who it's for** โ Kids? Trivia buffs? Work colleagues?
- **How hard** โ Easy, medium, hard, or a mix?
- **How many questions** โ 5, 10, 20?
- **The style** โ Multiple choice? True/false?
- **Any extras** โ Timers, themes, fun facts after each answer?
### Example ideas that work well:
> *"A 10-question multiple-choice quiz about classic 1980s arcade games, aimed at casual gamers. Include fun trivia and
> explanations for each answer."*
> *"A 15-question true/false quiz about world geography for middle school students. Medium difficulty, with a fun fact
> after each question."*
> *"A 20-question pub-style trivia quiz covering movies, music, and sport from the 1990s. Hard difficulty, mixed
> question styles."*
---
## โป๏ธ Refining Your Quiz
Not quite right? No problem. Quiz Wiz makes it easy to tweak your game:
1. Write your feedback in the **Update / Refine** box at the bottom of the page.
2. Click **๐พ Save Notes**, then **โป๏ธ Apply Updates**.
3. Your game will be rebuilt with your changes applied.
You can do this as many times as you like. Be as specific as you want โ the more clearly you describe what to change,
the better the result.
### Example feedback notes:
```
- The timer feels too short โ give players 30 seconds per question instead of 15
- Add a progress bar so players can see how far through the quiz they are
- Use a dark colour theme
- Show the correct answer and an explanation after each question
- Fix the final score screen โ it's not showing the total correctly
```
---
## ๐ฅ๏ธ Reading the Screen
The Quiz Wiz interface is made up of simple cards, one per step. Here's what to look for:
- **Status badges** โ Each step shows a coloured badge: `pending` (not started), `running` (in progress), `done`
(finished), or `error` (something went wrong).
- **โถ๏ธ Open Game** โ Appears and becomes clickable once your game has been built successfully.
- **๐ View Files** โ Browse the files generated at each step.
- **๐ก Active Sessions** โ Shows live progress for any AI tasks currently running.
- **๐ Activity Log** โ A running record of everything that's happened, useful if something goes wrong.
---
## ๐ค Frequently Asked Questions
**Do I need to know how to code?**
Not at all. Quiz Wiz handles all the technical work. You just describe what you want in plain English.
**How long does each step take?**
Most steps complete in under a minute. The Build step may take a little longer for complex quizzes.
**Can I share my quiz with others?**
Yes! Once built, your quiz runs in any modern web browser. Use the **โถ๏ธ Open Game** link to play it, and share that
link with anyone you like.
**What if a step fails?**
Check the **๐ Activity Log** for details. You can usually just try running the step again. If the problem persists,
check the **๐ก Active Sessions** panel for a monitor link to see exactly what happened.
**Can I change the quiz topic completely?**
Yes โ update your idea in Step โ and re-run the pipeline from Step โก onwards.
**Will my changes in the Update step break anything?**
Quiz Wiz is designed to apply only the changes you ask for, leaving everything else untouched. If something does break,
just describe the issue in the Update box and run it again.
---
## โ ๏ธ Troubleshooting
| Problem | What to do |
|---------|-----------|
| *"Could not determine session from URL"* | Make sure you're opening the app via its proper session link |
| A step badge is stuck on `running` | Check the **๐ก Active Sessions** panel and the **๐ Activity Log** |
| The **โถ๏ธ Open Game** button isn't appearing | The Build step may not have finished โ check the Activity Log and try again |
| The quiz doesn't look right | Use the **โฆ Update / Refine** step to describe what needs fixing |
| Models not loading | Check your internet connection and try refreshing the page |
---
*Quiz Wiz is part of the DocOps apps suite.*