durable-objects

1# Durable Objects
2 
3Build stateful, coordinated applications on Cloudflare's edge using Durable Objects.
4 
5## Retrieval Sources
6 
7Your knowledge of Durable Objects APIs and configuration may be outdated. **Prefer retrieval over pre-training** for any Durable Objects task.
8 
9| Resource | URL |
10|----------|-----|
11| Docs | https://developers.cloudflare.com/durable-objects/index.md |
12| API Reference | https://developers.cloudflare.com/durable-objects/api/index.md |
13| Best Practices | https://developers.cloudflare.com/durable-objects/best-practices/index.md |
14| Examples | https://developers.cloudflare.com/durable-objects/examples/index.md |
15| Roles and permissions | https://developers.cloudflare.com/workers/authorization/durable-objects/index.md |
16 
17Fetch the relevant doc page when implementing features.
18 
19## When to Use
20 
21- Creating new Durable Object classes for stateful coordination
22- Implementing RPC methods, alarms, or WebSocket handlers
23- Reviewing existing DO code for best practices
24- Configuring wrangler.jsonc/toml for DO bindings and migrations
25- Writing tests with Cloudflare’s Vitest integration
26- Designing sharding strategies and parent-child relationships
27 
28## Reference Documentation
29 
30- `./references/rules.md` - Core rules, storage, concurrency, RPC, alarms
31- [Testing reference](./references/testing.md) - Current Vitest documentation, migration choices, and test selection
32- `./references/workers.md` - Workers handlers, types, wrangler config, observability
33…