Skip to content

Improve Durable Objects intro by saying what it does. #19298

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Jan 20, 2025
Merged

Improve Durable Objects intro by saying what it does. #19298

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
442f6d0
Improve Durable Objects intro by saying what it does.
kentonv Jan 19, 2025
0e86518
Rephrase the "what it solves" part of the Durable Objects landing page.
kentonv Jan 19, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 11 additions & 2 deletions src/content/docs/durable-objects/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,9 +19,18 @@ Create collaborative applications, real-time chat, multiplayer games and more wi

<Plan type="paid" />

Durable Objects provide a powerful compute API for coordinating multiple clients or users. Each Durable Object has private, transactional and strongly consistent storage attached.
Durable Objects provide a building block for stateful applications and distributed systems.

Use Durable Objects to build collaborative editing tools, interactive chat, multiplayer games and applications that need coordination among multiple clients, without requiring you to build serialization and coordination primitives on your own.
Use Durable Objects to build applications that need cordination among multiple clients, like collaborative editing tools, interactive chat, multiplayer games, and deep distributed systems, without requiring you to build serialization and coordination primitives on your own.

### What is a Durable Object?

A Durable Object is a special kind of [Worker](/workers/). Like a Worker, it is automatically provisioned geographically close to where it is requested, it starts up quickly when needed and shuts down when idle, and you can have millions of them around the world. However, unlike regular Workers:

* Each object has a **globally-unique name**, allowing you to send requests to a specific object from anywhere in the world. Thus, a Durable Object can be used to coordinate between multiple clients who need to work together.
* Each object has some **durable storage** attached. Since this storage lives together with the object, it is strongly consistent yet fast to access.

Thus, Durable Objects enable **stateful** serverless applications.

<LinkButton href="/durable-objects/get-started/walkthrough/">Get started</LinkButton>

Expand Down
Loading