Wrangler v1 reaches end of life: What Cloudflare users need to know
Cloudflare is officially deprecating version 1 of Wrangler, its CLI tool for creating, modifying, and deploying Workers. The @cloudflare/wrangler npm package will receive no new features or bug fixes unless they are critical, and starting August 2023, no further updates will be published and the Wrangler v1 GitHub repo will be archived.
The deprecation follows the release of Wrangler 2.0, which introduced offline development, zero-config startup, and built-in developer tools support. Cloudflare recommends that all users migrate to version 2 (wrangler on npm), and has published a migration guide to facilitate the transition.
Why a total rewrite
Cloudflare engineers see Wrangler as the primary interface between developers and the Workers platform. Over time, however, the original codebase became difficult to maintain and grew in complexity. A full rewrite was chosen as the path forward, culminating in the 2.0 release last year.
While semver-major releases typically introduce breaking changes, Cloudflare says it worked to minimize friction for existing users. The team published documentation for breaking changes, provided deprecation messages in the tool itself, and monitored issue reports to respond with fixes. Download statistics eventually showed version 2 surpassing version 1 on npm.
What users should do next
For most developers, the deprecation will be a non-event—a majority of users are already on version 2. Those still running version 1 should consult the migration guide and upgrade. Users encountering bugs or unexpected behavior during migration can file an issue on the workers-sdk repository.
