Skip to content

3. Create Your First Quiz

Time: ~2 minutes

Now that your credentials are set, let's create a session and load some questions.


Create a session

python quiz_manager.py create "My First Quiz"

Output:

✓ Created session: My First Quiz
  Code: A3K7N2
  ID: 550e8400-e29b-...

The code (e.g., A3K7N2) is what students will type to join.

Load questions

The project comes with a demo quiz (3 questions). Load it into your session:

python quiz_manager.py add-questions A3K7N2 examples/demo_questions.json

Replace A3K7N2

Use the code from your create command output above.

Output:

Adding 3 questions to session 'My First Quiz'...
  ✓ Added: What is 2 + 2?...
  ✓ Added: In one word, describe your favorite programmi...
  ✓ Added: What is your favorite thing about this class?...

✓ Added 3 questions successfully!

That's it — your quiz is ready. The questions are stored in Supabase and will show up when you open the presenter.


What's in the demo quiz?

The file examples/demo_questions.json has one of each question type:

# Question Type
1 What is 2 + 2? Multiple choice (with correct answer)
2 Describe your favorite programming language Word cloud
3 What is your favorite thing about this class? Open-ended

See Writing Questions for how to write your own.


Next: 4. Run a Live Session