v1.2.2

🚀 Release Notes - v1.2.2

✨ What's New

🔧 Under the Hood (Architecture Improvements)

• Major App Overhaul – Modern React patterns with Context API & custom hooks.
• Smarter State Management – No more messy passing of data everywhere; everything is managed in one place.
• Stronger Connections – The app is now much better at staying connected and will reconnect automatically if needed.
• Ghosted Player Cleanup System – The app regularly runs server-side cleanup to remove ghosted players. Enhancments opportunities remain, but now ghosted players will drop from the game automatically

🎨 Better Player Experience

• Auto-Reconnect – If you refresh the page or close/reopen the browser, you’ll jump back into your game instantly.
• Clear Connection Status – Always know if you’re connected, reconnecting, or offline.

⚙️ Technical & Reliability Upgrades

• Clearer Error Messages – If something goes wrong, you’ll know why and how to fix it.
• Performance Tracking – The server keeps an eye on connection health.
• Game Persistence – Games survive even if the server restarts.
• Better Debugging Tools – Easier for us (and you) to spot and fix issues.

🎉 UI & Visual Enhancements

• Confetti Party – Automatic confetti when everyone agrees on the estimate.
• Mobile Friendly – The app works smoother and looks better on phones.

🏗️ Infrastructure Updates

• Improved Docker Setup – Easier to run in containers, with proper permissions.
• Health Checks – Built-in system checks to keep things running smoothly.
• Memory Cleanup – Old, unused games are cleared out automatically.
• Configurable Logging – New LOG_LEVEL environment variable lets you choose how much detail the logs show (DEBUG, INFO, WARN, ERROR, SILENT).

---

🐛 Bug Fixes

• Fixed issues where players couldn’t rejoin after disconnecting.
• Back/forward browser buttons now behave correctly.
• Stale games and old connections are cleaned up properly.
• Fixed timing issues that caused game state glitches.

---

📱 Compatibility

• Works better on phones and tablets.
• Handles flaky internet connections more gracefully.
• Adapts better to different screen sizes.

---

Full Changelog: https://github.com/andrew-busbee/planning-poker/commits/v1.2.2

v1.2.1

🚀 Release Notes - v1.2.1

🐛 Bug Fixes

🔌 Connection Stability Improvements

• Fixed frequent disconnects – Improved WebSocket connection handling for better reliability.
• Better reconnection – App now reconnects automatically when connection is lost.
• Smarter timeouts – Aligned client and server timeout settings to prevent premature disconnections.
• Network adaptation – App automatically adjusts connection method based on your internet speed.

🧹 Code Cleanup

• Removed mobile-specific code – Simplified connection logic for better performance across all devices.
• Unified connection handling – One connection strategy that works well on both desktop and mobile.

---

💡 What This Means For You

• Fewer connection drops during planning poker sessions
• Smoother experience when switching between browser tabs
• Better performance on slower internet connections
• More reliable game state preservation when reconnecting

---

✨ These improvements should significantly reduce the connection issues users were experiencing.

Full Changelog: v1.2.0...v1.2.1

v1.2.0

v1.2.0 – 24-Hour Game Persistence, Improved Reliability & Smarter Connections

🚨 Notable Changes

• Deployment Requirement:
  The docker-compose.yml file has been updated to include persistent storage for game files. You should update your compose file to take advantage of the new persistence system. Changes are included in the sample docker-compose.yml file which also includes an optional healthcheck.

🎯 What's New

24-Hour Game Persistence

• File Persistence (JSON Backup)
  • Games saved every 5 minutes to allow re-joining later
  • Games remain available for up to 24 hours after the last player leaves, with plans to extend persistence even longer
  • Any activity (votes, resets, deck changes, etc.) resets the 24-hour timer

🐛 Bug Fixes

• Fixed issue where users got stuck outside games after backgrounding the app
• Fixed reconnection timeout – app now properly shows disconnection after 10 seconds
• Fixed connection status visibility – clearer when connection is lost/restored
• Fixed confusing auto-rejoin on page refresh behavior

🐳 Container Images

• Published to GHCR: ghcr.io/andrew-busbee/planning-poker:1.2.0
• Published to Docker Hub: andrewbusbee/planning-poker:1.2.0
• ✅ Multi-platform support: linux/amd64, linux/arm64

Full Changelog: v1.1.0...v1.2.0

v1.1.0

v1.1.0 - Estimation Timer & UI Enhancements

🎨 Enhancements

• Introduced new card back designs.
• Added a custom favicon.
• Improved UI formatting for a cleaner appearance.
• Added an Estimation Timer to track how long each voting round takes.

🐛 Bug Fixes

• Squashed minor bugs to improve overall stability and usability.

🛠️ Notes

• This release delivers visual improvements and a new timer feature.
• All functionality remains the same.

Full Changelog: v1.0.1...v1.1.0

v1.0.1

🛠 Release v1.0.1 — Security Patch

This release addresses a security vulnerability identified in one of our dependencies.

🔒 Security Fix

• CVE-2024-21538 — Fixed a Regular Expression Denial of Service (ReDoS) vulnerability in the cross-spawn package by upgrading to version 7.0.5 or later.
  • Impact: Versions of cross-spawn before 7.0.5 were vulnerable to ReDoS due to improper input sanitization.
  • Risk: An attacker could craft a malicious string to significantly increase CPU usage and potentially crash the application.
  • Status: Patched in this release.

✅ Recommended Action

All users should upgrade to v1.0.1 as soon as possible to ensure they are protected from this vulnerability.

🔗 References

• GitHub Advisory for CVE-2024-21538

Full Changelog: v1.0.0...v1.0.1

v1.0.0

🎉 Release v1.0.0 — First Stable Release

After several beta iterations, Planning Poker is now ready for general use!
This release marks the first stable version, bringing a polished UI, robust Docker support, and reliable real-time gameplay for agile estimation sessions.

✨ Highlights

• Stable release suitable for production deployments
• Real-time voting powered by WebSockets
• Multiple built-in card decks:
  • Fibonacci
  • T-Shirt sizing
  • Powers of 2
  • Linear (1–10)
  • Custom decks
• Watcher mode for stakeholders and observers
• Light/Dark themes with responsive design for desktop & mobile
• No login required — shareable game URLs created instantly

🐳 Deployment

• Optimized Docker image with multi-stage build
• Built-in health checks
• Runs as a non-root user for improved security
• Simple startup via docker-compose up -d
• Reverse proxy ready (nginx, Traefik)

🖼️ Improvements Since Beta

• Polished UI across game, watcher, and setup screens
• More reliable vote reveal & reset handling
• Improved mobile experience
• Cleaner Docker workflow and smaller image size

⚠️ Notes

• This release is intended as the baseline for future updates
• Feedback and contributions are welcome as we continue to grow Planning Poker!

v0.1.0-beta.2

🚀 Release v0.1.0-beta.2

This pre-release adds polish to the Planning Poker app and Docker setup, making it easier to try out in real agile team sessions.

✨ Features

• Real-time planning poker with WebSocket communication
• Multiple built-in card decks:
  • Fibonacci (default)
  • T-Shirt sizing
  • Powers of 2
  • Linear (1-10)
  • Custom decks
• Watcher mode for non-voting participants
• Light/Dark mode toggle
• Mobile-friendly responsive design
• No login required — shareable game URLs generated automatically

🐳 Docker & Deployment

• Multi-stage Docker build for a smaller, optimized image
• Container health checks and non-root user for security
• Works with docker-compose up -d out of the box
• Configurable via PORT environment variable
• Ready for reverse proxy setups (nginx, Traefik, etc.)

🖼️ UI Improvements

• New game menu
• Player and Watcher views
• Consistent styling in light & dark modes

⚠️ Notes

• This is a beta release. Expect updates as we prepare for the stable 1.0.0 release.
• Feedback, bug reports, and contributions are welcome!

Full Changelog: v0.1.0-beta.1...v0.1.0-beta.2

v0.1.0-beta.1

🚀 Release v0.1.0-beta.1

This is the first public cut of Planning Poker — an early beta to get the core functionality working.
Expect rough edges and limited polish, but it’s a good starting point for testing with your team.

✨ Initial Features

• Basic real-time planning poker with WebSocket communication
• Multiple card decks (Fibonacci, T-Shirt sizing, Powers of 2, Linear)
• Simple game creation with shareable URLs
• Players can cast votes and reveal results
• Watcher mode for observers

🐳 Docker Support

• Initial Docker setup with docker-compose up -d
• Basic image build for local testing

⚠️ Notes

• This is an early beta — not production ready
• Focused on core gameplay, not UI polish
• Feedback and bug reports are highly encouraged!

Full Changelog: Initial beta release — no previous versions