# Story Points

> Realtime pointing poker for agile teams. No accounts — a room URL is the
> invitation and the capability. Create or claim a room at https://story-points.danielrose7.workers.dev/room/<slug>,
> vote with hidden cards, auto-reveal, themes, round history, and a plain-HTTP
> API for importing backlogs and exporting results.

Key facts: rooms persist between sessions (Cloudflare Durable Objects); the
room slug in the URL is the only credential; the API base is https://story-points.danielrose7.workers.dev.
Free and open source (MIT), self-hostable on the Cloudflare Workers free
plan. Built by Daniel Rose (https://gobloom.io) in Silverton, CO.

## Docs

- [Overview](https://story-points.danielrose7.workers.dev/docs/index.md): What Story Points is and where to find everything
- [Getting started](https://story-points.danielrose7.workers.dev/docs/getting-started.md): Create a room, invite the team, vote, reveal
- [Features](https://story-points.danielrose7.workers.dev/docs/features.md): Ticket queue, history, countdown, voting modes, stats, and the toggles for all of them
- [Themes](https://story-points.danielrose7.workers.dev/docs/themes.md): The 29 themes — year-rounders, the seasonal calendar, and regional celebrations that follow your room's locale
- [Compare](https://story-points.danielrose7.workers.dev/docs/compare.md): How Story Points stacks up against PlanningPoker.com, Parabol, Jira plugins, and story-points.app — and when to pick something else
- [API](https://story-points.danielrose7.workers.dev/docs/api.md): Plain-HTTP import/export — the integration surface for scripts, CLIs, and agents
- [Agent setup](https://story-points.danielrose7.workers.dev/docs/agent-setup.md): Teach any AI coding agent to drive Story Points in one step
- [Self-host](https://story-points.danielrose7.workers.dev/docs/self-host.md): Run your own Story Points on the Cloudflare free plan in three commands — the eject hatch is the point

## API quick reference

- POST https://story-points.danielrose7.workers.dev/api/room/<room>/queue — import stories (text lines or JSON {"items":[…]}; ?mode=replace)
- GET https://story-points.danielrose7.workers.dev/api/room/<room>/export — session results as JSON (?format=csv for CSV)
- GET https://story-points.danielrose7.workers.dev/api/room/<room>/peek — {"exists": bool, "locked"?, "name"?, "theme"?}
- Protected rooms (opt-in) return 401 from queue/export: send the room's
  6-char code as ?code= or an X-Room-Code header — it's in the invite link.
  Ask the user for it; never guess (10 misses = 15-minute lockout).

## Optional

- [Full docs in one file](https://story-points.danielrose7.workers.dev/llms-full.txt): all pages concatenated
- [Source repository](https://github.com/danielrose7/story-points): Workers + Durable Objects + Lit