Quiz Builder¶

The quiz builder is a browser-based tool for creating sessions, writing questions, customizing your theme, and downloading ready-to-use HTML files. No install required.

Launch Quiz Builder

Getting connected¶

When you open the quiz builder, you'll see a setup screen with two options:

Enter credentials manually¶

Paste your Supabase URL (e.g., https://abc123.supabase.co)
Paste your Anon Key
Click Connect

Credentials are saved in your browser's localStorage, so you won't need to re-enter them next time.

Upload an existing file¶

If you've already downloaded a presenter.html or student.html file, click Upload existing HTML file and select it. The builder extracts your Supabase credentials from the file and pre-fills the form. Click Connect to proceed.

This is the easiest way to get back to editing if you've already set things up before.

What you can do¶

Create and manage sessions¶

Type a session name and click Create to start a new session
Click any session to select it and manage its questions
Deactivate sessions you no longer need

Build questions visually¶

Pick a question type: Multiple Choice, Word Cloud, or Open-Ended
Type the question text
For multiple choice: add options, click the radio button to mark the correct answer
Click Add Question — it's saved to Supabase immediately
Delete questions you don't want

Import questions from JSON¶

Click Import questions.json to bulk-load questions from a previously exported file. The format matches what Export questions.json produces:

[
  {
    "text": "What is the capital of France?",
    "type": "multiple_choice",
    "options": ["London", "Paris", "Berlin", "Madrid"],
    "correct": "Paris"
  },
  {
    "text": "Describe your reaction in one word",
    "type": "word_cloud"
  }
]

Customize the theme¶

Pick custom colors for your quiz:

Setting	What it changes
Accent color	Buttons, join code, highlights
Accent hover	Button hover states
Background (dark)	Gradient start
Background (light)	Gradient end

A live preview strip shows how the colors look together.

You can also set a custom title (e.g., "Econ 101 Polls") that replaces the default "Classroom Polls" / "Join Poll" headings.

Download self-contained files¶

Click Download presenter.html or Download student.html to get HTML files with:

Your Supabase credentials baked in (no config.js needed)
Your custom theme colors applied
Your custom title applied

These files are completely standalone — upload them anywhere and they just work.

You can also Export questions.json to back up your questions or transfer them to another session.

Typical workflows¶

First time setup¶

Create a Supabase project and set up the database tables
Open the Quiz Builder
Enter your Supabase URL and Anon Key → Connect
Create a session, add questions, pick colors
Download presenter.html and student.html
Open presenter.html on your laptop for class

Editing an existing quiz¶

Open the Quiz Builder
Upload your existing presenter.html or student.html → credentials auto-fill
Click Connect
Select your session, add/remove questions, adjust theme
Download updated files

Export your questions.json
Send them the JSON file and your Supabase credentials
They open the Quiz Builder, connect, create a new session, and import the questions

When to use the Quiz Builder vs. the CLI¶

Task	Quiz Builder	CLI
Create a session
Add a few questions	Best for this
Bulk-load 50 questions from a file	via import	Best for this
Customize colors
Export results
Download themed HTML files