# Wrangler Wrangler is the [[Cloudflare]] Developer Platform CLI — the canonical tool for developing, deploying, and managing [[Cloudflare Workers]], [[Cloudflare Pages]], [[Cloudflare R2]], [[Cloudflare D1]], [[Cloudflare KV]], [[Cloudflare Vectorize]], [[Cloudflare Queues]], [[Cloudflare Hyperdrive]], [[Cloudflare Pipelines]], [[Cloudflare Workers AI]], [[Cloudflare Containers]], Workflows, and Secrets Store. Installed via `npm install -g wrangler` (or run ad-hoc via `npx wrangler`). Configuration lives in `wrangler.jsonc` or `wrangler.toml` at the project root, declaring bindings, routes, compatibility dates, and environment variables. ## Why It Matters Everything on the Workers platform — local dev, deployments, tail logs, secrets, resource provisioning — flows through Wrangler. There is no UI-equivalent for most operations. If you build on Cloudflare, you live in this CLI. ## Core Commands - `wrangler dev` — local Workers runtime with hot reload (uses `workerd`) - `wrangler deploy` — publish to Cloudflare - `wrangler tail` — stream live logs from a deployed Worker - `wrangler secret put/list/delete` — manage encrypted env vars - `wrangler kv:key`, `wrangler r2`, `wrangler d1` — resource-specific subcommands - `wrangler login` — OAuth-based auth (or `CLOUDFLARE_API_TOKEN` env var for CI) ## `wrangler.jsonc` Highlights - `name` — Worker name (becomes part of the deployed URL) - `main` — entry script - `compatibility_date` — pins runtime behavior; bump deliberately - `bindings` — KV, R2, D1, DO classes, Queues, AI, Vectorize, secrets - `routes` — custom domain routing - `triggers` — cron schedules ## Common Pitfalls - **Compatibility flags** — Node compat, navigator userAgent, etc. require explicit opt-in - **Local vs remote bindings** — `wrangler dev` defaults to local resources; pass `--remote` for production data - **Secrets in `wrangler.jsonc`** — never commit secrets; use `wrangler secret put` instead ## References - Wrangler home: https://developers.cloudflare.com/workers/wrangler/ - GitHub: https://github.com/cloudflare/workers-sdk ## Related - [[Cloudflare]] - [[Cloudflare Workers]] - [[Cloudflare Pages]] - [[Cloudflare Durable Objects]] - [[Cloudflare R2]] - [[Cloudflare D1]] - [[Cloudflare KV]] - [[Cloudflare Vectorize]] - [[Cloudflare Queues]] - [[Cloudflare Workers AI]] - [[TypeScript]]