Gesture Feedback
A kiosk website for collecting student feedback with hand gestures. You keep a list of questions on the admin page and assign each one to one or more variants. The kiosk runs one variant at a time and asks that variant's questions in random order. Until someone waves at it, the kiosk shows an idle screen. There are three variants:
- 👍👎 Agree / disagree. The student holds a thumbs up (agree) or thumbs down (disagree) in front of the camera for 3 seconds.
- ⭐ 1–5 stars. Five outline stars are shown below the question. The student points their index finger at a star, which fills that star and all the stars before it, and holds it for 1 second to submit the rating.
- ✋ 1–5 fingers. The student holds up 1 to 5 fingers, thumb included, for 3 seconds. The number of fingers is the rating. Numbered chips 1–5 light up to show the count the kiosk sees.
Hand tracking runs in the browser with MediaPipe Gesture Recognizer. Video never leaves the device. Only the answer is sent to the server.
Running it
Requires Node.js 22.13 or newer and Docker (OrbStack or Docker Desktop) for the Postgres database.
docker compose up -d
npm install
ADMIN_PASSWORD=choose-a-password npm start
If ADMIN_PASSWORD isn't set, the password is admin. Set a real one before using it with students.
Questions and answers are stored in Postgres 17, which docker-compose.yml runs on 127.0.0.1:5434 with its data in the pgdata Docker volume. The server creates its tables on start. Set DATABASE_URL to use another database (default postgres://feedback:feedback@localhost:5434/feedback).
questions: the text and the variants it is assigned to (variants, an array).answers: one row per answer, with the question, the variant it was given in, and answer (agree/disagree, thumbs) or rating (1–5, stars and fingers). Deleting a question deletes its answers.settings: the variant and camera the kiosk uses.
To start over, run docker compose down -v, which also deletes the volume.
Importing the old SQLite data
Earlier versions stored everything in data/feedback.db. To copy that into Postgres once:
npm run import-sqlite
Statements with the same text become one question, assigned to every variant they were asked in, and their votes and ratings become that question's answers with the original timestamps. The import only runs into an empty database and never changes the SQLite file. Set DB_PATH to import a different file.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
