← Back to app

Planning Poker β€” full guide

Everything in the app: joining, voting, the story queue, skip & export, moderator βš™οΈ settings, header buttons, chat, and keyboard shortcuts. Share this page so you don’t have to explain it in standup.

1. Join or create a room

No account or password. Pick an avatar, enter your name, then Create Room or Join Room.

Create

  1. Choose an avatar and name.
  2. Pick a deck: Fibonacci, T-shirt, powers of 2, or linear 1–10.
  3. Click Create Room β€” you are the moderator (MOD badge).

Join

  1. Enter the 6-character code or open an invite link (?code=ABC123).
  2. Optional: join as spectator to watch without voting.

πŸ’‘ Moderator: copy the invite link with πŸ“‹ or show πŸ“± QR next to the room code. Use Rejoin on the landing page to return to your last room.

3. Stories, Now bar & queue

Now bar (above the table)

  • Shows the story the team is estimating right now.
  • Moderator clicks the story text to edit title + ticket URL (Jira, Linear, GitHub…).
  • β†— link chips open the ticket in a new tab for everyone.
  • X of Y voted shows progress before reveal.

Load & pre-point (prep mode)

When the queue has stories but nothing is live yet, you see Load & pre-point:

  1. Paste URLs or titles (moderator can edit rows).
  2. Team picks cards to pre-point upcoming items β€” others see βœ“ and avatars, not your numbers.
  3. Moderator clicks β–Ά Start first story when ready (or πŸ“₯ Bulk import for many lines at once).

Story queue (πŸ“‹ sidebar)

  • Add one story or use bulk import (Title | https://url per line).
  • Tap a queued story to pre-point ahead while another story is live β€” use ← Current under the cards to return to the live vote.
  • β–Ά Next Story (after reveal) pulls the next item; pre-points merge into live votes.
  • Moderator βœ• removes from queue with no history row. Moderator ⏭ on a row skips with history + CSV.

4. Skip stories (moderator)

Use skip when a ticket shouldn’t be estimated (wrong item, duplicate, out of scope, etc.). Skipped items appear in the sidebar History tab with a Skipped badge and optional reason β€” and in Export CSV with status Skipped.

How to skip

  1. Click the gold ⏭ Skip in the header (before πŸ’¬), or ⏭ on a row in prep / the queue sidebar.
  2. A centered dialog opens on top of everything (not hidden under the queue).
  3. Add an optional reason β†’ Skip story.

You can skip the live Now story even when teammates are pre-pointing other queue items. Use row ⏭ to skip a queued ticket without touching the live one.

  • Live story on the table: clears the round, logs skip, moves to the next queued story if any.
  • Queued story only: removes it from the queue and logs skip β€” current live story keeps going.

Skipped stories do not count toward session vote totals. After a reveal, skipping the same story replaces that round’s history row instead of duplicating it.

5. Voting

Cards sit below the table under Your vote.

  • Click a number (or T-shirt size) β€” others see βœ“ on your avatar, not your value.
  • Click the same card again to clear your vote.
  • Second row: 🀷 unsure, β˜• break, ∞ too big when your deck includes them.
  • πŸ‘ Spectate or β˜• Break in the status bar to sit out the round.

Keyboard: 1–9 for the first nine cards; ? or / for unsure (when not typing in a field).

6. Round flow (table center)

ControlWhenWhat
🎴 RevealModerator, before/during vote3-2-1 countdown, flip cards, show stats (can reveal before everyone votes)
Agreed estimateAfter revealModerator taps the final number the team picked (auto on consensus)
πŸ’¬ Discuss & re-voteAfter revealSame story, votes cleared, discussion round
πŸ”„ Next RoundAfter revealSame story, fresh votes
β–Ά Next StoryAfter reveal, queue not emptyNext queue item becomes live; pre-points apply
πŸ”” Nudge allModerator, before revealPing everyone who hasn’t voted yet

After reveal you may see: average, median, min/max, vote chart, outlier callout, chaos meter, consensus confetti, and a recap plaque. Notes preview appears in the results panel when set.

7. Settings panel (βš™οΈ)

Click βš™οΈ in the header to expand settings below the bar. Appearance and Sound are personal (only affect your browser). The Moderator block appears only if you are the moderator.

Appearance (everyone)

Pick a theme chip: ♠️ Aurum (default), πŸŒ‘ Dark, 🎰 Casino, ⚑ Neon, 🌊 Ocean. Themes are not synced to the room β€” each person chooses their own.

Sound (everyone)

ToggleWhat it controls
Sound effectsReveal, nudge, timer chime, throws, streaks, etc. Turning on plays a short test chime (browser may require a tap to unlock audio).
Ambient musicSoft looping background jazz in the lounge. Turn off here β€” it stops for you immediately (not shared with the room).

Moderator (MOD only)

ControlWhat it does
Round timerManual β€” pick 30s, 1m, 2m, or 3m to start a countdown for the current voting round. It does not start automatically when a new story begins β€” start it again each round if you use it.
Timer in headerEveryone sees the countdown next to the room tools while it runs.
At zeroTimer chime for everyone; if auto-reveal is on and cards aren’t revealed yet, reveal runs automatically.
StopCancels the active timer.
Auto-reveal when all votedReveals when every active voter has pointed, or when the round timer hits zero (if still unrevealed).
Reset roundClears all votes for the same story (no reveal needed).

Deck type is chosen when the room is created (Fibonacci, T-shirt, powers of 2, or linear 1–10). If the moderator leaves, MOD passes to someone else β€” they get the moderator block, ⏭ Skip, and room controls.

From a player menu (β‹― on a seat): throw projectiles, emoji reactions, or πŸ‘‘ Make moderator.

πŸ’‘ Your seat: click your avatar on the table to change it anytime β€” everyone sees the update.

9. Chat & extras

  • πŸ’¬ Chat β€” sidebar; unread dot on the button.
  • Throws & reactions β€” from a player’s β‹― menu (tomatoes, emoji bubbles, etc.).
  • Theme & sound β€” under βš™οΈ Settings (see Settings), not separate header buttons.
  • PWA β€” installable from the browser; cached shell can load offline (live rooms still need network).
  • Rooms persist ~24 hours via realtime sync; refresh or late joiners catch up when Supabase is configured.

10. Keyboard shortcuts

KeyAction
1–9Vote with first nine cards in deck
? / /Unsure vote
EnterReveal (moderator)
RNext round (moderator, after reveal)
EscClose modals, cancel throw targeting, close skip/help

Quick reference

I want to…Do this…
Start a sessionCreate Room β€” you’re moderator
Invite peopleπŸ“‹ link or πŸ“± QR
Load backlogπŸ“‹ sidebar β†’ add or bulk import β†’ Start first story
Estimate current ticketVote β†’ moderator 🎴 Reveal β†’ agree estimate
Skip (no points)Header ⏭ Skip or queue row ⏭ β†’ History + CSV
Remove queue item quietlyModerator βœ• on row (not in export)
Pre-point later storiesTap story in queue β†’ vote β†’ ← Current to return
Discuss and re-voteπŸ’¬ Discuss & re-vote
Export for emailπŸ“‹ β†’ History tab β†’ ⬇ Export CSV
Change theme or mute soundsβš™οΈ Settings β†’ Appearance / Sound
Timebox a voteModerator: βš™οΈ β†’ Round timer (manual each round)
Read this againHeader ? (full-screen guide overlay)