Skip to content

[docs] List the Cloudflare World under Managed - #4618

Merged
pranaygp merged 2 commits into
mainfrom
cloudflare-world-managed
Oct 5, 2026
Merged

pranaygp merged 2 commits into
mainfrom
cloudflare-world-managed

Conversation

@pranaygp

@pranaygp pranaygp commented Oct 3, 2026 •

Copy link
Copy Markdown
Contributor

Moves the Cloudflare World listing on the Worlds index out of Self-Hosted and into Managed, as requested in Slack.

Why it was in the wrong bucket

WorldsFilteredGrid sorts Worlds into three sections using two allowlists, with Self-Hosted as the catch-all:

const managedIds = new Set(['vercel']);
const embeddedIds = new Set([...]);
// Self-Hosted: !managedIds.has(id) && !embeddedIds.has(id)

Because managedIds only contained vercel, the Cloudflare World fell through to Self-Hosted by default. Cloudflare Durable Objects is a managed platform — you deploy onto it rather than run it yourself — and the World is flagged requiresDeployment: true in worlds-manifest.json, the same as the Vercel World. So the fix is to add it to the allowlist.

The change

-const managedIds = new Set(['vercel']);
+const managedIds = new Set(['vercel', 'fantasticfour-cloudflare']);

Resulting sections

Section Before After
Managed Vercel Vercel, Cloudflare
Self-Hosted 12 Worlds incl. Cloudflare 11 Worlds
Embedded 5 Worlds unchanged

Cloudflare sorts after Vercel in Managed, following manifest order. The filter chips (Show all / By Vercel / By Community / Encrypted) are independent of sectioning and are unaffected — Cloudflare still counts as a community World.

Managed section copy

The Managed blurb listed e2e encrypted among the attributes every World in the section shares, which stopped holding once Cloudflare joined it — Cloudflare does not declare the encryption feature in worlds-manifest.json, only Vercel does. Reworded per review:

-'Production grade — zero configuration, high throughput, infinitely-scalable, e2e encrypted, and integrated observability'
+'Production grade — zero configuration, high throughput, infinitely-scalable, and integrated observability, plus end-to-end encryption on Worlds marked Encrypted'

Scoped to the marker already on the page rather than deleted: WorldCardSimple renders a visible Encrypted badge for any World declaring the feature, and the filter chip uses the same word. That keeps the claim accurate as Worlds gain the feature, without the blurb needing another edit.

Testing

  • Simulated the section-matching logic against worlds-manifest.json to confirm the bucketing above.
  • biome check passes on the modified file.

🤖 Generated with Claude Code

The worlds index buckets each World into Managed, Self-Hosted, or
Embedded. Managed is an explicit allowlist and Self-Hosted is the
fallback, so the Cloudflare World was showing under Self-Hosted.

Cloudflare Durable Objects is a managed platform — you deploy to it
rather than run it yourself (the World is flagged `requiresDeployment`
in worlds-manifest.json, same as Vercel), so add it to `managedIds`.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

Co-Authored-By: Pranay Prakash <1797812+pranaygp@users.noreply.github.com>
@pranaygp
pranaygp requested a review from a team as a code owner October 3, 2026 01:41
Copilot AI balanced review requested due to automatic review settings October 3, 2026 01:41
@vercel

vercel Bot commented Oct 3, 2026 •

Copy link
Copy Markdown
Contributor

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
example-nextjs-workflow-turbopack Ready Ready Preview, v0 Oct 5, 2026 2:59pm UTC
example-nextjs-workflow-webpack Ready Ready Preview, v0 Oct 5, 2026 2:59pm UTC
example-workflow Ready Ready Preview, v0 Oct 5, 2026 2:59pm UTC
workbench-astro-workflow Ready Ready Preview, v0 Oct 5, 2026 2:59pm UTC
workbench-express-workflow Ready Ready Preview, v0 Oct 5, 2026 2:59pm UTC
workbench-fastify-workflow Ready Ready Preview, v0 Oct 5, 2026 2:59pm UTC
workbench-hono-workflow Ready Ready Preview, v0 Oct 5, 2026 2:59pm UTC
workbench-nestjs-workflow Ready Ready Preview, v0 Oct 5, 2026 2:59pm UTC
workbench-nitro-workflow Ready Ready Preview, v0 Oct 5, 2026 2:59pm UTC
workbench-nuxt-workflow Ready Ready Preview, v0 Oct 5, 2026 2:59pm UTC
workbench-python-workflow Ready Ready Preview, v0 Oct 5, 2026 2:59pm UTC
workbench-sveltekit-workflow Ready Ready Preview, v0 Oct 5, 2026 2:59pm UTC
workbench-tanstack-start-workflow Ready Ready Preview, v0 Oct 5, 2026 2:59pm UTC
workbench-vite-workflow Ready Ready Preview, v0 Oct 5, 2026 2:59pm UTC
workflow-docs Ready Ready Preview, v0 Oct 5, 2026 2:59pm UTC
workflow-swc-playground Building Building Preview, v0 Oct 5, 2026 2:59pm UTC
workflow-tarballs Ready Ready Preview, v0 Oct 5, 2026 2:59pm UTC
workflow-web Ready Ready Preview, v0 Oct 5, 2026 2:59pm UTC

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@changeset-bot

changeset-bot Bot commented Oct 3, 2026 •

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 40771f3

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@github-actions

github-actions Bot commented Oct 3, 2026 •

Copy link
Copy Markdown
Contributor

Sim World

Simulated world deterministic testing for races. Traces

🟠 world-sim scenario book — 1 fail of 42 total

fence=per-spec

scenario outcome events virt replay violations
✅ smoke-no-steps completed 3 0ms ok 0
✅ smoke-one-step completed 6 0ms ok 0
✅ hook-at-step-started completed 12 0ms ok 0
✅ hook-at-step-completed completed 12 0ms ok 0
✅ hook-at-hook-created completed 12 0ms ok 0
✅ deadline-hook-wins completed 7 1.0h ok 0
✅ deadline-expires completed 7 1.0h ok 0
✅ step-vs-timer-early-settlement completed 8 1.0h ok 0
✅ long-sleep completed 11 30.0d ok 0
✅ hook-never-arrives stalled 3 0ms skipped 0
✅ step-retries-twice completed 10 2.0s ok 0
✅ parallel-steps completed 9 0ms ok 0
✅ hook-on-execution-state completed 12 0ms ok 0
✅ peek-hook-before-branch completed 12 0ms ok 0
✅ peek-hook-after-branch completed 12 0ms ok 0
✅ peek-hook-at-registration completed 12 0ms ok 0
✅ race-hook-before-probe completed 12 0ms ok 0
✅ race-hook-after-probe completed 12 0ms ok 0
✅ race-duplicate-delivery completed 13 0ms ok 0
✅ attr-hook-before-step completed 11 0ms ok 0
✅ attr-hook-after-step completed 11 0ms ok 0
✅ attr-from-step-body completed 13 0ms ok 0
✅ fork-hook-after-timeout completed 14 1.0m ok 0
✅ fork-hook-before-timeout completed 14 1.0m ok 0
✅ count-hook-after-timeout completed 17 1.0m ok 0
✅ count-hook-before-timeout completed 20 1.0m ok 0
✅ stale-read-step-count-fork completed 20 1.0m ok 0
✅ stale-read-equal-step-counts completed 14 1.0m ok 0
✅ step-vs-step-fork completed 12 0ms ok 0
✅ step-vs-step-fork-fenced completed 12 0ms ok 0
✅ fence-catches-benign-direction completed 12 5ms ok 0
✅ in-flight-before-decision completed 17 1.0m ok 0
❌ in-flight-before-decision-counted completed 17 1.0m ok 0
✅ in-flight-after-decision completed 19 2.0m ok 0
✅ stale-read-step-count-fork-fenced completed 20 1.0m ok 0
✅ fork-hook-wins completed 13 1.0m ok 0
✅ fork-timeout-wins completed 13 1.0m ok 0
✅ unclaimed-payload-under-fork completed 17 1.0m ok 0
✅ claimed-payload-under-fork completed 17 1.0m ok 0
✅ writers-independent-step-bodies completed 12 0ms ok 0
✅ writers-scripted-tempo completed 12 0ms ok 0
✅ cancel-mid-step cancelled 7 0ms skipped 0

Full trace: world-sim.txt

@VaguelySerious VaguelySerious left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cloudflare does not declare the encryption feature in worlds-manifest.json (Vercel does), so "e2e encrypted" no longer holds for every World in this section. I left the copy alone since the ask was scoped to the move

Reword would be good

The Managed blurb listed "e2e encrypted" alongside the attributes every
World in the section shares, which stopped being true once Cloudflare
joined it: Cloudflare does not declare the `encryption` feature in
worlds-manifest.json, only Vercel does.

Each card already renders a visible "Encrypted" badge for Worlds that
declare the feature, and the filter chip uses the same label, so point
at that marker instead of dropping the claim.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

Co-Authored-By: Pranay Prakash <1797812+pranaygp@users.noreply.github.com>

pranaygp commented Oct 5, 2026

Copy link
Copy Markdown
Contributor Author

@VaguelySerious reworded in 40771f3.

-'Production grade — zero configuration, high throughput, infinitely-scalable, e2e encrypted, and integrated observability'
+'Production grade — zero configuration, high throughput, infinitely-scalable, and integrated observability, plus end-to-end encryption on Worlds marked Encrypted'

Rather than just dropping the claim, I scoped it to the marker that already exists: WorldCardSimple renders a visible Encrypted badge for any World declaring the encryption feature, and the filter chip above the grid uses the same word — so "Worlds marked Encrypted" points at something the reader can actually see on the page. Today that's Vercel in this section, but it keeps reading correctly as Worlds add the feature.

Went with the copy change over adding encryption to the Cloudflare manifest entry, since that should follow the World actually supporting it rather than the other way round.

@pranaygp
pranaygp merged commit 0fa6990 into main Oct 5, 2026
65 of 66 checks passed
@pranaygp
pranaygp deleted the cloudflare-world-managed branch October 5, 2026 15:50
@github-actions

github-actions Bot commented Oct 5, 2026

Copy link
Copy Markdown
Contributor

No backport to stable for 0fa6990 (AI decision).

The only changed file is docs/components/worlds/WorldsFilteredGrid.tsx, part of the docs app outside docs/content/, which is not maintained on stable (confirmed absent: git ls-tree origin/stable -- docs/components returns nothing). The change is also a presentation-only recategorization of a World on the docs site, with no bearing on the maintenance line's correctness or releasability.

To override, re-run the Backport to stable workflow manually via workflow_dispatch and paste this commit SHA into the ref input:

0fa6990a6071c9d2ab177165370e836c7c519b8f

pranaygp added a commit that referenced this pull request Oct 6, 2026
Catches the docs up with SDK changes that landed on Oct 5 without
(complete) docs updates.

| Change | Source PR | Docs edit |
| --- | --- | --- |
| zstd is only written to runs whose deployment's Node.js can decode it
| #4640 | The encryption page said "gzip, with zstd support in the
format". It now states when zstd vs. gzip is used and links
`WORKFLOW_COMPRESSION_CODEC` |
| Aborting a public writable keeps the accepted prefix and doesn't close
the shared stream | #4605 | Added to the existing `releaseLock()` /
`close()` callout in Streaming |
| Released stream writers retire their WebSocket and continue over HTTP
| #4605 | Short paragraph under `WORKFLOW_STREAMS_TRANSPORT` on the
Vercel World page, including the "hold the lock for a burst" tip from
the `world-vercel` README |

I reviewed the other Oct 5 PRs and they need no further docs: NestJS
(#4604) shipped its own docs, the `@vercel/queue` bump (#4648) and
`world-local` hook fix (#4636) aren't user-facing in the docs, and
#4632/#4618 are docs PRs. The Workflows pages in `vercel/front` were
also checked and need no changes for these.

## Docs Preview

| Page | Preview |
| --- | --- |
| Encryption |
[Compression](https://workflow-docs-git-workflow-docs-cleanup-tue-6-oct.vercel.sh/docs/how-it-works/encryption#compression)
|
| Streaming | [Writing to another run's
stream](https://workflow-docs-git-workflow-docs-cleanup-tue-6-oct.vercel.sh/docs/foundations/streaming#writing-to-another-runs-stream)
|
| Vercel World |
[`WORKFLOW_STREAMS_TRANSPORT`](https://workflow-docs-git-workflow-docs-cleanup-tue-6-oct.vercel.sh/worlds/vercel#workflow_streams_transport)
|

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: vercel[bot] <35613825+vercel[bot]@users.noreply.github.com>
Co-authored-by: Pranay Prakash <1797812+pranaygp@users.noreply.github.com>

This branch was successfully deployed

1 active deployment
Preview – workflow-docs — 40771f3b Deployed Oct 5, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants