Change8

Cloudflare Workers

Backend & Infra

⛅️ Home to Wrangler, the CLI for Cloudflare Workers®

Latest: @cloudflare/deploy-helpers@0.1.0100 releases6 breaking changes3 common errorsView on GitHub

Release History

@cloudflare/deploy-helpers@0.1.01 feature
May 26, 2026

This minor release introduces a new internal package, @cloudflare/deploy-helpers, containing shared types and code for deployment operations.

@cloudflare/vitest-pool-workers@0.16.91 fix2 features
May 22, 2026

This patch updates dependencies and significantly shrinks the published bundle size by correctly deriving bundler externals from package.json and improving tree-shaking.

@cloudflare/vite-plugin@1.38.01 feature
May 22, 2026

This release introduces QR code generation for Cloudflare Tunnel URLs during local development for improved mobile accessibility. It also includes dependency updates for Wrangler and Miniflare.

@cloudflare/pages-shared@0.13.139
May 22, 2026

This patch release primarily consists of dependency updates, specifically upgrading miniflare to version 4.20260521.0.

@cloudflare/cli-shared-helpers@0.1.4
May 22, 2026

This patch release primarily involved updating internal dependencies, specifically @cloudflare/workers-utils to version 0.21.1.

@cloudflare/workers-utils@0.21.11 fix2 features
May 22, 2026

This patch improves tree-shaking for @cloudflare/workers-utils by marking it as side-effect-free and correctly declares undici as a runtime dependency, fixing unresolved import issues.

wrangler@4.94.02 fixes3 features
May 22, 2026

This release introduces groundwork for scheduled Workflow triggering via cron expressions in bindings and improves local development by adding QR codes for tunnels and fixing Access Service Token authentication issues. Wrangler also now supports automatic installation of AI coding agent skills.

miniflare@4.20260521.01 fix
May 22, 2026

This patch release updates dependencies, including workerd, and fixes an issue where TCP requests failed when an outboundService was configured.

@cloudflare/containers-shared@0.15.11 fix
May 21, 2026

This patch release improves local development cleanup by ensuring sibling container image tags are preserved when multiple containers share a Dockerfile.

@cloudflare/pages-shared@0.13.1381 fix
May 21, 2026

This patch release fixes an issue where relative link hrefs were not correctly resolved against the document's base href during early hint Link header generation. Dependencies, including miniflare, were also updated.

@cloudflare/vitest-pool-workers@0.16.82 fixes
May 21, 2026

This patch fixes an inconsistency in how the CF-Worker header is generated during local development, ensuring it correctly reflects the parent zone name as it does in production. Dependencies including miniflare and wrangler have also been updated.

miniflare@4.20260520.03 fixes
May 21, 2026

This patch primarily addresses security vulnerabilities by updating the `ws` dependency and improves local development reliability by enhancing error reporting and adding self-healing for the Browser Run binding cache. It also corrects an issue with host validation for cdn-cgi routes in Miniflare.

@cloudflare/vite-plugin@1.37.33 fixes
May 21, 2026

This patch primarily addresses security concerns by updating the `ws` dependency and fixes several bugs related to host validation and the `CF-Worker` header generation during local development.

@cloudflare/workflows-shared@0.11.02 features
May 21, 2026

This release introduces rollback support for local Workflows development, enabling steps to define compensation callbacks that execute upon workflow failure. Rollback configuration is passed via new options to `step.do`.

wrangler@4.93.15 fixes
May 21, 2026

This patch primarily addresses security vulnerabilities by updating the `ws` dependency and fixes several inconsistencies in local development environments related to host validation and the `CF-Worker` header. It also improves authentication token precedence and error reporting in Wrangler.

wrangler@4.93.06 fixes3 features
May 19, 2026

This release introduces new commands for querying the Workers AI model catalog (`ai models schema` and `ai models list`) and adds deployment control via `--containers-rollout=none`. Several bug fixes address issues related to D1 migrations, local Workflow startup, and cleanup of temporary files.

miniflare@4.20260518.01 fix1 feature
May 19, 2026

This release updates dependencies, including workerd, and introduces support for `using` and `await using` keywords in script parsing via Miniflare updates. A bug preventing local Workflow startup with the experimental flag is also resolved.

create-cloudflare@2.68.3
May 19, 2026

This patch release primarily updates various dependencies within the "create-cloudflare" tooling, including updates to create-vite, nuxi, and Angular related packages.

@cloudflare/containers-shared@0.15.0Breaking1 fix1 feature
May 19, 2026

This release introduces the `--containers-rollout=none` flag for deployment control and refactors an internal Docker verification utility for better readability and extensibility.

@cloudflare/vitest-pool-workers@0.16.71 fix
May 19, 2026

This patch primarily fixes an issue where dynamically wrapped RPC methods could invoke out of order for Workers and Durable Objects. Dependencies including wrangler and miniflare have also been updated.

@cloudflare/pages-shared@0.13.137
May 19, 2026

This patch release primarily consists of dependency updates, specifically upgrading miniflare to version 4.20260518.0.

@cloudflare/vite-plugin@1.37.21 fix
May 19, 2026

This patch release fixes an issue where WebSocket upgrade requests were not routed correctly in development mode and updates underlying dependencies.

miniflare@4.20260515.0
May 15, 2026

This patch release updates dependencies for "miniflare" and "wrangler", specifically updating the bundled workerd version.

wrangler@4.92.05 fixes2 features
May 15, 2026

This release introduces CLI support for managing Cloudflare Artifacts via new `wrangler artifacts` commands and adds the `--keep-vars` flag to `wrangler versions upload`. Several critical bugs related to authentication token refreshing and URL query string manipulation in `wrangler dev` have also been resolved.

@cloudflare/pages-shared@0.13.136
May 15, 2026

This patch release primarily updates internal dependencies, specifically upgrading miniflare to version 4.20260515.0.

@cloudflare/vite-plugin@1.37.11 fix1 feature
May 15, 2026

This patch updates dependencies and enhances the Cloudflare Vite plugin to honor the X-Forwarded-Proto header for correct request URL construction in proxied environments, and adds a tunnel shortcut hint to CLI output.

@cloudflare/vitest-pool-workers@0.16.61 fix
May 15, 2026

This patch release updates dependencies, including Miniflare and Wrangler, and filters noisy WebSocket disconnection messages during testing.

@cloudflare/devprod-status-bot@1.5.01 feature
May 14, 2026

This minor release introduces enhanced issue tracking by automatically posting Chat alerts to a dedicated webhook for issues tagged with the "api" label.

miniflare@4.20260511.01 feature
May 14, 2026

This patch updates the underlying workerd dependency and introduces header propagation for trace IDs in remote binding proxy requests.

@cloudflare/vite-plugin@1.37.01 feature
May 14, 2026

This release introduces named Cloudflare Tunnel support for the Vite plugin and updates underlying dependencies including Wrangler and Miniflare.

@cloudflare/pages-shared@0.13.135
May 14, 2026

This patch release primarily involves updating dependencies, specifically bumping miniflare to version 4.20260511.0.

@cloudflare/vitest-pool-workers@0.16.5
May 14, 2026

This patch release primarily focuses on updating internal dependencies, specifically upgrading wrangler to version 4.91.0 and miniflare to version 4.20260511.0.

wrangler@4.91.05 fixes3 features
May 14, 2026

This release introduces named tunnel support for stable local development hostnames via `wrangler dev`. It also includes several bug fixes, such as normalizing instance type aliases and ensuring worker preview bindings match deployment behavior for non-string variables.

wrangler@4.90.14 fixes
May 12, 2026

This patch release focuses on stability fixes, particularly addressing issues in `wrangler dev` related to hotkey cleanup during shutdown and ensuring remote binding updates complete before subsequent operations. Dependencies, including workerd, have also been updated.

@cloudflare/workers-shared@0.19.6
May 12, 2026

This patch temporarily hardcodes the asset worker cohort to "ent" for latency testing, disabling the cohort-based version routing in the outer entrypoint.

@cloudflare/vite-plugin@1.36.41 fix
May 12, 2026

This patch release updates the bundled Vite module runner to incorporate a critical bug fix from Vite. It also updates dependencies including miniflare and wrangler.

@cloudflare/vitest-pool-workers@0.16.4
May 12, 2026

This patch release primarily updates internal dependencies, specifically upgrading miniflare to version 4.20260508.0 and wrangler to version 4.90.1.

create-cloudflare@2.68.2
May 12, 2026

This patch release primarily updates various dependencies within the "create-cloudflare" tooling, including updates to create-vike, sv, Angular create, create-react-router, @tanstack/create-start, create-next-app, and create-waku.

@cloudflare/pages-shared@0.13.134
May 12, 2026

This patch release primarily involves updating dependencies, specifically upgrading miniflare to version 4.20260508.0.

miniflare@4.20260508.01 feature
May 12, 2026

This release introduces support for configuring workerd autogates via an environment variable and updates internal dependencies, including workerd.

@cloudflare/devprod-status-bot@1.4.21 feature
May 7, 2026

The status bot's message generation has been migrated from the deprecated Llama 2 7B chat model to the Gemma 4 model.

@cloudflare/cli-shared-helpers@0.1.3
May 7, 2026

This patch release primarily involved updating dependencies, specifically upgrading @cloudflare/workers-utils to version 0.21.0.

@cloudflare/vite-plugin@1.36.3
May 7, 2026

This patch release updates the bundled dependencies wrangler and miniflare to their latest versions.

@cloudflare/vitest-pool-workers@0.16.3
May 7, 2026

This patch release updates the bundled dependencies for wrangler and miniflare to newer versions.

@cloudflare/workers-utils@0.21.0
May 7, 2026

This release introduces a deprecation warning for the unused `delivery_delay` setting in queue producer bindings, directing users to use `wrangler queues update` for configuration.

wrangler@4.90.02 fixes
May 7, 2026

This release introduces a deprecation warning for the unused `delivery_delay` setting in queue producer bindings and fixes bugs related to account token authentication and Containers SSH configuration.

miniflare@4.20260507.11 fix1 feature
May 7, 2026

This patch improves the hosted images mock for local development by ensuring variant URLs in ImageMetadata point to a functional local delivery endpoint, fixing issues with image rendering during local testing.

@cloudflare/pages-shared@0.13.133
May 7, 2026

This patch release primarily updates internal dependencies, specifically upgrading miniflare to version 4.20260507.1.

@cloudflare/vitest-pool-workers@0.16.21 feature
May 7, 2026

This patch introduces the ability to import .wasm files as modules using the .wasm?module syntax and updates underlying dependencies.

wrangler@4.89.11 fix
May 7, 2026

This patch release fixes a bug where container deployment was incorrectly skipped for Workers for Platforms user workers using --dispatch-namespace. Dependencies were also updated.

@cloudflare/vite-plugin@1.36.2
May 7, 2026

This patch release primarily consists of dependency updates for wrangler and miniflare.

wrangler@4.89.05 fixes2 features
May 7, 2026

This release introduces configurable HTTP caching for Workers and standardizes local development timezone to UTC to match production environments. Several bugs related to asset bindings in previews, type checking, and authentication listing were also resolved.

@cloudflare/vite-plugin@1.36.11 fix
May 7, 2026

This patch release fixes a bug related to quote handling in `.dev.vars` files generated during `vite preview` and updates several dependencies, including miniflare and wrangler.

@cloudflare/vitest-pool-workers@0.16.1
May 7, 2026

This patch release primarily focuses on updating internal dependencies, specifically upgrading miniflare to version 4.20260507.0 and wrangler to version 4.89.0.

miniflare@4.20260507.01 fix3 features
May 7, 2026

This release enhances the Email Sending API with support for named recipients in the MessageBuilder and aligns Miniflare's local development environment timezone with production by defaulting workerd to UTC.

@cloudflare/workers-utils@0.20.02 features
May 7, 2026

This release introduces a new `cache` configuration option in Wrangler to enable HTTP caching for Workers fetch handlers, with specific support for preview deployments.

@cloudflare/cli-shared-helpers@0.1.2
May 7, 2026

This patch release primarily involves updating internal dependencies, specifically @cloudflare/workers-utils to version 0.20.0.

@cloudflare/pages-shared@0.13.132
May 7, 2026

This patch release primarily involves updating dependencies, specifically upgrading miniflare to version 4.20260507.0.

@cloudflare/vite-plugin@1.36.01 fix2 features
May 5, 2026

This release stabilizes the 'secrets' configuration property in Wrangler, adding validation for required secrets, and enhances security by preventing the Vite dev server from fetching credential files.

wrangler@4.88.05 fixes5 features
May 5, 2026

This release stabilizes the `secrets` configuration, enhances `wrangler deploy` with interactive prompts for missing configuration, and introduces support for `builtin` AI Search instances and custom metadata.

@cloudflare/cli-shared-helpers@0.1.1
May 5, 2026

This patch release primarily involved updating internal dependencies, specifically @cloudflare/workers-utils to version 0.19.0.

@cloudflare/workers-utils@0.19.02 features
May 5, 2026

This minor release stabilizes the `secrets` configuration property in Wrangler, enhancing validation during development and deployment.

@cloudflare/workers-shared@0.19.51 fix
May 5, 2026

This patch introduces logic during deployment to route asset-worker requests based on account plans and adds validation to reject invalid `_headers` rules containing multiple wildcards or wildcard/:splat combinations.

miniflare@4.20260504.03 fixes
May 5, 2026

This patch release primarily updates internal dependencies, including workerd, and fixes a critical race condition affecting Browser Run on Windows when launching Chrome.

create-cloudflare@2.68.1
May 5, 2026

This patch release primarily updates various dependencies within the "create-cloudflare" tooling, including updates for @tanstack/create-start, create-waku, create-docusaurus, and @angular/create.

@cloudflare/vitest-pool-workers@0.16.01 fix2 features
May 5, 2026

This release stabilizes the 'secrets' configuration property and fixes an issue where self-referencing service bindings broke due to runner worker renaming during testing.

@cloudflare/pages-shared@0.13.131
May 5, 2026

This patch release primarily focused on updating internal dependencies, specifically upgrading miniflare to version 4.20260504.0.

@cloudflare/vite-plugin@1.35.01 feature
Apr 30, 2026

This release introduces support for the V2 protocol for module fallback service when the new module registry flag is enabled. It also includes internal refactoring of the router-worker for future gradual rollout.

wrangler@4.87.0Breaking2 fixes2 features
Apr 30, 2026

This release enforces Node.js 22 as the minimum required version and introduces an experimental programmatic API for generating Worker types. It also fixes deployment logic when using explicit configuration flags and improves asset directory handling for development proxies.

@cloudflare/workers-shared@0.19.4
Apr 30, 2026

The router-worker has been refactored to separate invocation from business logic, preparing for future gradual rollouts based on user plans, but resulting in no immediate functional change.

@cloudflare/workflows-shared@0.10.01 feature
Apr 30, 2026

Introduced a new feature allowing developers to restart local Workflows execution from a specified step, leveraging cached results from preceding steps for faster iteration.

create-cloudflare@2.68.0Breaking
Apr 30, 2026

This release enforces a minimum Node.js version of 22, dropping support for Node.js 20.x, and includes several minor dependency updates within create-cloudflare.

miniflare@4.20260430.0Breaking3 fixes4 features
Apr 30, 2026

This release enforces a minimum Node.js version of 22, introduces local restart support for Workflows, and fixes several local development issues related to Hyperdrive connections and data serialization.

@cloudflare/vitest-pool-workers@0.15.2
Apr 30, 2026

This patch release primarily focuses on updating underlying dependencies, specifically miniflare and wrangler, to their latest versions.

@cloudflare/kv-asset-handler@0.5.0Breaking
Apr 30, 2026

Wrangler has dropped support for Node.js 20.x, enforcing a minimum requirement of Node.js 22.0.0.

@cloudflare/pages-shared@0.13.130
Apr 30, 2026

This patch release primarily updates dependencies, including an update to miniflare to version 4.20260430.0.

@cloudflare/vitest-pool-workers@0.15.1
Apr 28, 2026

This patch release primarily focuses on updating internal dependencies, specifically upgrading wrangler to version 4.86.0 and miniflare to version 4.20260426.0.

@cloudflare/workers-shared@0.19.31 fix
Apr 28, 2026

This patch release fixes a TypeError in the router-worker when static routing is configured without user worker rules. The fix ensures proper iteration handling in the static routing matcher.

create-cloudflare@2.67.4
Apr 28, 2026

This patch release primarily updates various dependencies within the "create-cloudflare" tooling, including updates to create-vite, create-react-router, create-analog, and others.

@cloudflare/vite-plugin@1.34.01 fix3 features
Apr 28, 2026

This release introduces the ability to share local development and preview servers publicly using Cloudflare Quick Tunnels via a new `tunnel: true` option in the Vite plugin. Dependencies have also been updated.

@cloudflare/local-explorer-ui@0.13.32 fixes1 feature
Apr 28, 2026

This patch release focuses on improving the user experience of the instance page and fixing a bug where expanded workflow steps were incorrectly collapsing during polling.

wrangler@4.86.0Breaking3 fixes5 features
Apr 28, 2026

This release enhances CLI tooling with namespace support for AI Search, public sharing via Quick Tunnels in `wrangler dev`, and improved queue consumer listing. It also enforces remote access for Flagship bindings during local development.

miniflare@4.20260426.05 fixes1 feature
Apr 28, 2026

This release enhances local development by adding extended SSL mode support for Hyperdrive and forcing Flagship bindings to use remote services locally. Several bugs were fixed related to multi-worker setups, service binding props forwarding, and router-worker stability.

@cloudflare/pages-shared@0.13.129
Apr 28, 2026

This patch release primarily consists of dependency updates, specifically upgrading miniflare to version 4.20260426.0.

@cloudflare/pages-shared@0.13.128
Apr 27, 2026

This patch release primarily updates dependencies, including an update to miniflare to version 4.20260424.0.

@cloudflare/vite-plugin@1.33.22 fixes2 features
Apr 27, 2026

This patch release updates dependencies, improves Vite plugin local development by supporting Cloudflare registry images, and fixes the default compatibility date fallback behavior.

@cloudflare/vitest-pool-workers@0.15.02 features
Apr 27, 2026

This release introduces new testing utilities, `reset()` and `abortAllDurableObjects()`, to `cloudflare:test` for better state management in tests. It also includes dependency updates for wrangler and miniflare.

miniflare@4.20260424.02 fixes5 features
Apr 27, 2026

This release introduces local video serving capabilities, stable stream preview URLs via `publicUrl`, and fixes reliability issues with the dev registry watcher on Windows. Caption uploads via ReadableStream are also now supported locally.

create-cloudflare@2.67.3
Apr 27, 2026

This patch updates internal dependencies, specifically bumping `@clack/core` and `@clack/prompts` to version 1.2.0 within the CLI tools.

wrangler@4.85.05 fixes1 feature
Apr 27, 2026

This release introduces support for enabling/disabling production and preview traffic for custom domain routes and significantly improves error reporting when API requests are blocked by the Cloudflare WAF. Dependency updates for workerd and clack were also performed.

@cloudflare/cli-shared-helpers@0.1.01 feature
Apr 24, 2026

This release publishes the internal packages @cloudflare/cli-shared-helpers and @cloudflare/workers-utils to npm, updating the latter to version 0.18.0.

@cloudflare/containers-shared@0.14.11 fix1 feature
Apr 24, 2026

This patch introduces support for Cloudflare-managed registry images in the Vite plugin local development environment, resolving a crash when using `registry.cloudflare.com` images in container bindings.

@cloudflare/workflows-shared@0.9.11 fix
Apr 24, 2026

This patch release focuses on improving error handling by preserving the original message and name for NonRetryableError when the relevant compatibility flag is active.

@cloudflare/pages-shared@0.13.127
Apr 21, 2026

This patch release primarily involves updating dependencies, specifically upgrading miniflare to version 4.20260421.0.

miniflare@4.20260421.01 fix
Apr 21, 2026

This patch updates the bundled workerd dependency and resolves numerous sourcemap warnings present in miniflare when used within pnpm monorepos.

wrangler@4.84.11 fix
Apr 21, 2026

This patch release updates dependencies, including workerd, and fixes a bug in `wrangler types --check` related to environment interface and configuration resolution.

@cloudflare/vitest-pool-workers@0.14.9
Apr 21, 2026

This patch release updates underlying dependencies, specifically miniflare and wrangler, to newer versions.

create-cloudflare@2.67.21 feature
Apr 21, 2026

This patch release updates the design of the React Workers starter template to match the latest Vite React upstream design.

@cloudflare/local-explorer-ui@0.13.24 fixes
Apr 21, 2026

This patch release focuses on refining the Local Explorer UI, including improvements to D1 table selection and better handling of R2 empty states and navigation.

@cloudflare/vite-plugin@1.33.1
Apr 21, 2026

This patch release updates underlying dependencies, specifically miniflare and wrangler, to newer versions.

Common Errors

MiniflareCoreError4 reports

MiniflareCoreError often arises from conflicting or improperly configured bindings, especially when using browser bindings or multiple workers in the same environment. Ensure all bindings are correctly defined in your wrangler.toml or CLI arguments and that there are no conflicting binding types (e.g., attempting to use browser bindings with module workers simultaneously). If using multiple workers, verify each worker has unique binding names to avoid overlapping modules. Finally, double-check that the referenced modules in your bindings are correctly present and resolvable in your project.

InferenceUpstreamError1 report

The "InferenceUpstreamError" in Cloudflare Workers AI usually indicates a problem with the model being unavailable or timing out when accessed by the Workers AI inference server. Ensure the model ID is correct, the model is properly deployed and active on the Cloudflare AI platform, and that the Worker's request doesn't exceed any limits (memory, CPU time). Double-check Cloudflare status pages for service outages affecting Workers AI, and consider implementing retry logic with exponential backoff in your worker to gracefully handle temporary upstream issues; also consider downgrading wrangler to version 4.35.0 to mitigate any recent breaking changes.

DataCloneError1 report

The DataCloneError in Cloudflare Workers usually arises when attempting to pass non-cloneable objects (like functions, class instances with methods, or certain DOM nodes) across the Worker's boundaries via message passing or durable objects. To fix this, ensure you only send plain JavaScript objects and primitive data types between Workers. If you need to transfer complex data, serialize it into a JSON string before sending, and then deserialize it on the receiving end, or redesign your code to avoid sending such data in the first place.

Related Backend & Infra Packages

Subscribe to Updates

Get notified when new versions are released

RSS Feed