quizterm/README.md
2026-04-15 20:04:56 +02:00

1.9 KiB

Welcome to QUIZTerm

Building and running

Docker, or a compatible container manager, like podman, is required to build and run quizterm. The alternative is to install Gleam and Erlang/BEAM and run it dockerless. Unless you plan to do Gleam development, using Docker will save a lot of hassle.

To compile project and build docker image, write:

docker build . -t quizterm:1

quizterm can be whatever name you want to give the container, 1 can be changed to whatever you want the version of the container to be.

Start server on port 4321:

docker run -p 4321:1234 quizterm:1

Port 1234 is the port used internally in the docker container, while 4321 is the port exposed outside the container. The latter can be set to whatever port you want to use.

Open web browser and access http://localhost:4321

The rest of this readme is currently outdated and will be updated shortly

QUIZTerm is a simple online "quiz answering" game. It provides a way for contestants to provide answers to questions, and reveal the answers for everyone at the same time.

Cards showing who are playing, their answer status (have they answered or not?), and when revealed, what their answer was, will show up on everyones screen.

Not quite finished yet, it is at a point where it is "usable" enough.

Endpoints explained

Endpoint Usage
/room/<room_id> Create room with given room_id (max 200 rooms)
/board/<room_id> Join a game with the given room_id
/board/<room_id>/control Join a game with the given room_id with more control options
Ingame example Idle player
Screenshot Screenshot