Troubleshooting¶

"Configuration Required" in the browser¶

config.js is missing or still has placeholder values.

Fix: Run ./configure.sh or copy config.example.js to config.js and fill in your Supabase URL and anon key.

"Missing Supabase credentials" from quiz_manager.py¶

The CLI requires environment variables.

Fix:

export SUPABASE_URL='https://YOUR_PROJECT.supabase.co'
export SUPABASE_KEY='YOUR_ANON_KEY'

"Please install supabase"¶

Fix: pip install supabase

No questions show up in the presenter¶

You created a session but haven't loaded any questions yet.

Fix:

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

Students can't join¶

Check the URL — students need to access student.html, not presenter.html
Check the code — it's case-insensitive but must be 6 characters
Check the session is still active: python quiz_manager.py list

Votes don't appear in real time¶

Supabase Realtime may not be enabled. The schema.sql file enables it, but if you skipped those lines:

Fix: Run this in the Supabase SQL Editor:

ALTER PUBLICATION supabase_realtime ADD TABLE sessions;
ALTER PUBLICATION supabase_realtime ADD TABLE questions;
ALTER PUBLICATION supabase_realtime ADD TABLE votes;

"Error creating session" in the presenter¶

Open the browser console (++f12++) and check the error. Common causes:

Wrong credentials in config.js
Schema not applied yet (tables don't exist)
Missing RLS policies (re-run the full schema.sql)

CORS errors in the browser console¶

Serve the files through a web server instead of opening them directly from the file system:

python -m http.server 8000

Then open http://localhost:8000/presenter.html.