README

Poker Planner

Self-hosted planning poker for Symfony — hidden votes, Mercure realtime, story queue

Note

Read-only mirror. See CONTRIBUTING.md for how to propose changes.

Features

• Frictionless sessions — share /r/{uuid} links; guests join with a display name only
• Hidden votes — no vote values leak before moderator reveal (Mercure + Turbo streams)
• Fibonacci deck — ½, 1–21, ?, and coffee with simultaneous card flip
• Story queue — multi-story refinement with recorded estimates per round
• Consensus feedback — median, spread, and outlier hints after reveal
• Session recap — copy markdown summary to your tracker or notes
• ui-kernel theming — scheme switcher and token-driven room chrome
• Ephemeral Redis rooms — no database migrations in v0.1

Prerequisites

Add the symfinity/recipes Flex endpoint to your project's composer.json (see recipes README).

Recommended: symfony-docker (Symfony 7.4) — the Flex recipe adds Redis, Mercure env, routes, and Stimulus/Turbo assets. See Flex recipe (turnkey walkthrough) or Installation.

Otherwise you need Redis (or Predis) and a Mercure hub — see Installation.

Installation

composer require symfinity/poker-planner

On symfony-docker: accept Flex Docker configuration, then docker compose up -d --wait.

Quick Start

1. Open / (symfony-docker: https://localhost/), enter your name, and Start session.
2. Share the room URL; estimators vote; moderator Reveal then Next story.

See Quick start for the full walkthrough.

Documentation

• Flex recipe — symfony-docker turnkey, manifest reference, asset merge
• Installation — Composer, Flex recipe overview, infrastructure
• Quick start — first session in minutes
• Configuration — poker_planner.yaml reference
• Realtime sync — Mercure topics, Turbo streams, vote privacy (schematic diagrams)
• Upgrade — release 0.1.0 notes

Requirements

• PHP 8.2+
• Symfony 7.4+ or 8.x
• Redis or Predis
• Mercure hub (symfony/mercure-bundle)
• symfinity/ui-kernel, symfinity/ux-blocks, symfinity/ux-blocks-core

Support

• GitHub Issues
• Security
• Contributing

License

MIT