README.md

QOTD

A realtime question-of-the-day web app supporting multiple rooms.

Tech Stack

Backend

• Go
  • Gin
  • Gorilla WebSockets
  • gin-rate-limit
• Redis (optional)

Frontend

• React
  • Mantine
  • react-use-websocket

Running QOTD

Docker

To run the application yourself, you can start the published Docker image:

docker run -d -p 9075:9075 ghcr.io/ryan-willis/qotd:latest

Then visit http://localhost:9075 in your browser.

Development

You must have Go and Node installed on your machine to run the application in development.

macOS (via homebrew):

brew install go nvm
nvm use 22

Install dependencies:

npm install

Start the webserver:

npm run webserver

Then start the Vite dev server in a separate terminal:

npm run dev

Then visit http://localhost:5173 in your browser.