# cloudflare/workers-chat-demo

Repository: https://github.com/cloudflare/workers-chat-demo
Canonical: https://ross.abutalabs.com/products/workers-chat-demo
Language: JavaScript
License: BSD-3-Clause
License Family: permissive
Last push: 2026-04-23T22:45:10+00:00

## Health v2 (maintenance only)
Score: 67/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 78, release rhythm 35, longevity 100
- inputs: {"age_days": 2169, "days_push": 132, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1108, forks 240 (observed 2026-08-28T04:03:37.131796+00:00)

## What it is
A demo real-time chat application built on Cloudflare Workers using Durable Objects, with one object per chat room coordinating WebSocket connections and storing message history. It also demonstrates using Durable Objects as stateless per-IP rate limiters.

## Use cases
- build a real-time chat app on cloudflare workers
- learn how durable objects coordinate websocket connections
- implement per-ip rate limiting with durable objects
- example of websocket hibernation api usage
- deploy a stateful serverless app at the edge
- reference code for broadcasting messages between connected users

## When to choose
- you want a small, well-commented reference for Durable Objects and WebSockets on Cloudflare
- you need real-time message broadcasting with stored chat history at the edge
- you want to see stateless coordination objects used for rate limiting

## When to avoid
- you need a production-ready chat product with auth, moderation, or rich features
- you are not deploying on Cloudflare Workers
- you need chat rooms that scale beyond a single-threaded Durable Object per room

## Facets
- artifact type: application
- maturity: maintenance
- function: websocket, chat-interface, rate-limiting, webhook
- domain: web-development, developer-tools
- platform: cloud, serverless
- tags: cloudflare-workers, durable-objects, websocket-hibernation, edge-computing, demo-app, chat-rooms, real-time, javascript, web-server

## Member repositories
- cloudflare/workers-chat-demo (main) score 67

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:37.131796+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:43:45.278696+00:00, confidence not recorded.
  - readme: https://github.com/cloudflare/workers-chat-demo (fetched 2026-08-28T04:03:37.131796+00:00, sha 7a7088b3dd67)
- Data as of 2026-08-30T08:39:29.467469+00:00.