symfinity / poker-planner
Realtime planning-poker rooms with Mercure sync and hidden votes until reveal
Maintainers
Package info
github.com/symfinity/poker-planner
Type:symfony-bundle
pkg:composer/symfinity/poker-planner
Requires
- php: >=8.2
- ext-json: *
- symfinity/ui-kernel: ^0.1
- symfinity/ux-blocks: ^0.1
- symfinity/ux-blocks-core: ^0.1
- symfony/asset-mapper: ^7.4||^8.0
- symfony/config: ^7.4||^8.0
- symfony/dependency-injection: ^7.4||^8.0
- symfony/framework-bundle: ^7.4||^8.0
- symfony/http-foundation: ^7.4||^8.0
- symfony/http-kernel: ^7.4||^8.0
- symfony/mercure-bundle: ^0.3||^0.4
- symfony/routing: ^7.4||^8.0
- symfony/stimulus-bundle: ^2.0||^3.0
- symfony/twig-bundle: ^7.4||^8.0
- symfony/uid: ^7.4||^8.0
- symfony/ux-turbo: ^2.0||^3.0
- symfony/ux-twig-component: ^2.0||^3.0
- twig/twig: ^3.0
Requires (Dev)
- phpstan/phpstan: ^2.1
- phpstan/phpstan-symfony: ^2.0
- phpunit/phpunit: ^10.5||^11.0
- symfony/browser-kit: ^7.4||^8.0
- symfony/css-selector: ^7.4||^8.0
- symfony/yaml: ^7.4||^8.0
Suggests
- ext-redis: Native Redis extension (recommended for production)
- predis/predis: Pure-PHP Redis client when ext-redis is unavailable
- symfony/ux-icons: App icon and optional glyphs via ux_blocks_icon() (hugeicons:joker)
This package is auto-updated.
Last update: 2026-06-19 00:07:46 UTC
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
- Open
/(symfony-docker:https://localhost/), enter your name, and Start session. - 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.yamlreference - Realtime sync — Mercure topics, Turbo streams, vote privacy (schematic diagrams)
- Upgrade — release
0.1.0notes
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