A real-time Scrum Poker (Story Pointing) application built for agile teams. Fast, beautiful, and simple.
All project documentation lives in the docs/ directory. Start with the documentation map.
- Features — the full feature catalog.
- Usage guide — how to run a session (for players & facilitators).
- Getting started — run the app locally.
- Self-hosting — deploy it for real.
- Architecture — how it works, deep dive.
- Design decisions (ADRs) — every significant decision, with trade-offs.
- Protocol reference — the WebSocket wire format.
- Contributing — how to help improve the project (uses Git Flow).
- 🚀 Real-time Collaboration: Instant updates across all participants using WebSockets.
- 🏢 Room-based: Create or join specific rooms for different teams or sprint ceremonies.
- 🃏 Story Pointing: Fibonacci-based voting (1, 2, 3, 5, 8, 13, 21) plus the "?" card and the "A" (Abstain) card.
- 👁️ Vote Reveal: Hide votes until the team is ready to reveal them.
- 🔄 Quick Reset: Start new rounds with a single click.
- 🤝 Dealer-free Rounds: When no dealer is present, any non-AFK player can reveal results and start the next round.
- 🔗 Shareable Links: Easily invite team members by sharing the URL.
- 📱 Responsive Design: Works great on desktop and mobile.
- 🌙 Dark Theme: Light/dark/system theme with OS-preference detection and a manual override (persisted). Toggle in the header or on the join screen.
- ⚖️ Legal Pages: Imprint and Privacy Policy built into the app, reachable via hash routes (
/#/imprint,/#/privacy) from the footer.
- Framework: React 19
- Build Tool: Vite
- Language: TypeScript
- Styling: Tailwind CSS 4
- Icons: Lucide React
- Notifications: Sonner
- Language: Go 1.27
- Real-time: Gorilla WebSocket
- ID Generation: crypto/rand (server-side, per connection)
- Docker & Docker Compose (Recommended)
- OR Go 1.27+ and Node.js 26+ (for local development)
The easiest way to get started is using Docker Compose:
docker-compose up --build- Frontend: http://localhost:8081
- Backend: http://localhost:8080
- Navigate to the backend directory:
cd backend - Run the server:
go run .
- Navigate to the frontend directory:
cd frontend - Install dependencies:
npm ci
- Start the development server:
npm run dev
GPLv2