breaking: Move cloudflare bindings from `platform` to `cloudflare:workers` by ottomated · Pull Request #16754 · sveltejs/kit

ottomated · 2026-08-12T03:37:45Z

Breaking #16705 into smaller pieces; this is the first step of making the dev environment closer to the workerd runtime. Instead of accessing Cloudflare bindings on platform.env, you would do the following:

import { env } from 'cloudflare:workers';

export function GET({ request }) {
  const value = await env.KV.get('key'); // instead of platform.env
  const userCountry = request.cf.country; // instead of platform.cf
  const cache = caches.open('name'); // instead of platform.caches
}

Please don't delete this checklist! Before submitting the PR, please make sure you do the following:

It's really useful if your PR references an issue where it is discussed ahead of time. In many cases, features are absent for a reason. For large changes, please create an RFC: https://github.com/sveltejs/rfcs
This message body should clearly illustrate what problems it solves.
Ideally, include a test that fails without this PR but passes with it.

Tests

Run the tests with pnpm test and lint the project with pnpm lint and pnpm check

Changesets

If your PR makes a change that should be noted in one or more packages' changelogs, generate a changeset by running pnpm changeset and following the prompts. Changesets that add features should be minor and those that fix bugs should be patch. Please prefix changeset messages with feat:, fix:, or chore:.

pkg-svelte-dev · 2026-08-12T03:37:48Z

Install the latest version of @sveltejs/kit from 0f6072c:

pnpm add https://pkg.svelte.dev/@sveltejs/kit/c/0f6072c6b23b162fd2e8bf94290bea14a8104194

Open in pkg.svelte.dev: https://pkg.svelte.dev/repos/kit/pr/16754

changeset-bot · 2026-08-12T03:37:49Z

🦋 Changeset detected

Latest commit: 0f6072c

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@sveltejs/adapter-cloudflare	Major

Not sure what this means? Click here to learn what changesets are.

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

svelte-docs-bot · 2026-08-12T03:39:19Z

Preview: https://svelte-dev-git-preview-kit-16754-svelte.vercel.app/

Rich-Harris · 2026-08-13T21:59:03Z

+	enterSpan() {
+		throw new Error('tracing is not available in dev mode');
+	},
+	startActiveSpan() {
+		throw new Error('tracing is not available in dev mode');
+	}


should these just be no-ops in dev?

I wonder if it would be confusing if these didn't work and the user didn't know. SvelteKit tracing does work during dev (but I'm not sure what these functions do).

They are now no-ops, I don't think it'll be too confusing (and there's nothing we can do until they give us a non-mock implementation)

Rich-Harris · 2026-08-13T22:39:06Z

+	prerendering = true;
+}
+
+const als = new AsyncLocalStorage();


why do we need ALS here? isn't env always going to be the same?

They export a withEnv function like below. We could stub that but it's easy enough to get working

What is withEnv for?

Mocking the env object for child functions that import it globally (https://developers.cloudflare.com/workers/runtime-apis/bindings/#overriding-env-values)

as suggested in #16754, modernizes the cloudflare adapter's docs to mention `wrangler types`. No changeset because docs-only --- ### Please don't delete this checklist! Before submitting the PR, please make sure you do the following: - [x] It's really useful if your PR references an issue where it is discussed ahead of time. In many cases, features are absent for a reason. For large changes, please create an RFC: https://github.com/sveltejs/rfcs - [x] This message body should clearly illustrate what problems it solves. - [ ] Ideally, include a test that fails without this PR but passes with it. ### Tests - [x] Run the tests with `pnpm test` and lint the project with `pnpm lint` and `pnpm check` ### Changesets - [x] If your PR makes a change that should be noted in one or more packages' changelogs, generate a changeset by running `pnpm changeset` and following the prompts. Changesets that add features should be `minor` and those that fix bugs should be `patch`. Please prefix changeset messages with `feat:`, `fix:`, or `chore:`.

… instead

ottomated changed the title ~~Remove cloudflare platform~~ breaking: Move cloudflare bindings from platform to cloudflare:workers Aug 12, 2026

github-advanced-security AI found potential problems Aug 12, 2026

View reviewed changes

Comment thread packages/adapter-cloudflare/test/apps/workers/src/routes/prerender/+server.js Dismissed

vercel Bot reviewed Aug 12, 2026

View reviewed changes

Comment thread packages/adapter-cloudflare/package.json Outdated

Comment thread packages/adapter-cloudflare/src/virtual-cloudflare-workers.js Outdated

teemingc reviewed Aug 12, 2026

View reviewed changes

Comment thread documentation/docs/25-build-and-deploy/60-adapter-cloudflare.md

ottomated added the pkg:adapter-cloudflare label Aug 12, 2026

ottomated force-pushed the remove-cloudflare-platform branch from 1f442d6 to 04fd512 Compare August 13, 2026 21:20

vercel Bot reviewed Aug 13, 2026

View reviewed changes

Comment thread documentation/docs/60-appendix/35-migrating-to-sveltekit-3.md Outdated

ottomated force-pushed the remove-cloudflare-platform branch from b3c32be to 11e9241 Compare August 13, 2026 21:30