Daily Fleece 🦙

A mobile-first quiz app for daily standups. Two questions per session — knowledge and geography — played on players' own devices, with a running leaderboard.

How it works

1. Host uploads two photos — a knowledge calendar page (Q1) and a geography location (Q2)
2. Players join the lobby via the app on their phones
3. Host starts the quiz — players answer Q1 (A/B/C) then Q2 (country on a map)
4. Host reveals correct answers after closing each voting round
5. Leaderboard updates automatically — 1 point per correct answer, max 2 per session

Running locally

Backend

cd backend
./mvnw spring-boot:run

Frontend

cd frontend
npm install
npm start

Dev setup

Code formatting (palantir-java-format for Java, Prettier for TypeScript/HTML/YAML) is enforced in CI. Unformatted code will fail the pipeline.

To auto-format on every commit, install lefthook once after cloning:

brew install lefthook
lefthook install

lefthook is optional — the build and tests work without it. It is not required to run the app locally.

Docs

• REQUIREMENTS.md — use cases and rules
• CONTEXT.md — domain glossary
• docs/domain-model.md — entity model
• docs/adr/ — architecture decisions