Skip to content

INQTR/poker-planning

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

282 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AgileKit - Free Online Planning Poker for Scrum Teams

Live Demo License: MIT GitHub stars GitHub forks

The open-source planning poker tool that's completely free, requires no registration, and makes agile estimation simple for remote Scrum teams.

Try AgileKit Now | Report Bug | Request Feature

AgileKit Planning Poker Room - Free Scrum Estimation Tool AgileKit Planning Poker Room - Free Scrum Estimation Tool

Features

  • 100% Free - No premium tier, no hidden costs, no credit card required
  • No Registration - Create a room and start estimating in seconds
  • Real-time Collaboration - Instant vote synchronization across all participants
  • Modern Canvas Interface - Whiteboard-style room with intuitive drag-and-drop
  • Multiple Voting Scales - Fibonacci, Standard, T-Shirt sizes, or create custom scales
  • Issues Management - Create, edit, and track issues within planning sessions
  • CSV Export - Export issues with vote statistics (average, median, agreement)
  • Auto-Complete Voting - Automatic reveal with countdown when all participants vote
  • Vote Analytics - Average, median, and consensus percentage for each round
  • Visual Voting Progress - See who has voted at a glance with emoji indicators
  • Built-in Timer - Session timer for timeboxed estimation rounds
  • Spectator Mode - Join sessions as an observer without voting
  • Dark/Light Theme - Toggle themes or follow system preference
  • Auto-cleanup - Rooms automatically cleaned up after 5 days of inactivity
  • Open Source - Fully transparent codebase, self-host if you prefer

Quick Start

Option 1: Use the hosted version (recommended)

Visit agilekit.app, create a room, and share the link with your team.

Option 2: Self-host

# Clone the repository
git clone https://github.com/INQTR/poker-planning.git
cd poker-planning

# Install dependencies
npm install

# Start Convex backend (terminal 1)
npx convex dev

# Start Next.js dev server (terminal 2)
npm run dev

Open http://localhost:3000 in your browser.

Note: The repository is named poker-planning while the product is branded as AgileKit. This reflects our evolution from a single-purpose tool to a broader Agile toolkit.

Prerequisites

  • Node.js 20+
  • npm

Environment Variables

Copy .env.example to .env.local and configure the variables below.

Next.js (.env.local)

Variable Required Description
NEXT_PUBLIC_CONVEX_URL Yes Convex deployment URL (from npx convex dev)
NEXT_PUBLIC_CONVEX_SITE_URL Yes Convex site URL for BetterAuth (.convex.site)
NEXT_PUBLIC_SITE_URL No Your site URL (defaults to https://agilekit.app)
CONVEX_DEPLOY_KEY Prod Deploy key for production (from Convex dashboard)
NEXT_PUBLIC_GA_ID No Google Analytics 4 Measurement ID

Convex Server (via npx convex env set)

These variables run on Convex servers and cannot be set in .env.local.

Variable Required Description
SITE_URL Yes Base URL for auth callbacks
BETTER_AUTH_SECRET Yes Secret for signing sessions (min 32 chars)
# Development setup
npx convex env set SITE_URL http://localhost:3000
npx convex env set BETTER_AUTH_SECRET $(openssl rand -base64 32)

Technology Stack

Layer Technology
Frontend Next.js 15 (App Router), React 19, TypeScript
Backend Convex (serverless with real-time reactivity)
Styling Tailwind CSS 4, shadcn/ui
Canvas @xyflow/react
State Convex reactive queries

Running Tests

# Run all E2E tests
npm run test:e2e

# Run with Playwright UI for debugging
npm run test:e2e:ui

# Run in headless mode (CI)
npm run test:e2e:headless

Deployment

Frontend (Next.js)

Deploy to Vercel, Netlify, or any platform supporting Next.js:

npm run build

Backend (Convex)

npx convex deploy --prod

Use Cases

  • Sprint Planning - Estimate user stories with your Scrum team
  • Backlog Refinement - Collaboratively size your product backlog
  • Remote Estimation - Perfect for distributed and hybrid teams
  • Agile Training - Teach planning poker techniques interactively

Roadmap

  • Jira integration
  • Team velocity tracking
  • Session history (view past sessions)

Contributing

Contributions are welcome! Whether it's bug fixes, new features, or documentation improvements.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

Privacy & Analytics

The hosted version at agilekit.app uses Google Analytics 4 for basic usage analytics (page views, session duration). No personal data is collected beyond standard analytics. Self-hosted instances do not include analytics by default.

See our Privacy Policy for details.

Versioning

This project follows Semantic Versioning and uses Conventional Commits for automated releases.

License

This project is open source under the MIT License.


Made with care for the Agile community
agilekit.app - Free Planning Poker for Everyone

About

Free open-source planning poker for Scrum teams. No registration required. Real-time estimation for remote agile teams.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Contributors

Languages