diff --git a/src/content/changelog/workers/2025-09-09-interactive-wrangler-assets.mdx b/src/content/changelog/workers/2025-09-09-interactive-wrangler-assets.mdx new file mode 100644 index 000000000000000..6be3b71930d16d9 --- /dev/null +++ b/src/content/changelog/workers/2025-09-09-interactive-wrangler-assets.mdx @@ -0,0 +1,63 @@ +--- +title: Deploy static sites to Workers without a configuration file +description: Wrangler now guides you through deploying static assets with interactive prompts and automatic configuration generation when no wrangler.jsonc file exists. +products: + - workers +date: 2025-09-09 +--- + +Deploying static site to Workers is now easier. When you run `wrangler deploy [directory]` or `wrangler deploy --assets [directory]` without an existing [configuration file](/workers/wrangler/configuration/), [Wrangler CLI](/workers/wrangler/) now guides you through the deployment process with interactive prompts. + +## Before and after + +**Before:** Required remembering multiple flags and parameters +```bash +wrangler deploy --assets ./dist --compatibility-date 2025-09-09 --name my-project +``` + +**After:** Simple directory deployment with guided setup +```bash +wrangler deploy dist +# Interactive prompts handle the rest as shown in the example flow above +``` + +## What's new + +**Interactive prompts for missing configuration:** +- Wrangler detects when you're trying to deploy a directory of static assets +- Prompts you to confirm the deployment type +- Asks for a project name (with smart defaults) +- Automatically sets the compatibility date to today + +**Automatic configuration generation:** +- Creates a `wrangler.jsonc` file with your deployment settings +- Stores your choices for future deployments +- Eliminates the need to remember complex command-line flags + +## Example workflow + +```bash +# Deploy your built static site +wrangler deploy dist + +# Wrangler will prompt: +✔ It looks like you are trying to deploy a directory of static assets only. Is this correct? … yes +✔ What do you want to name your project? … my-astro-site + +# Automatically generates a wrangler.jsonc file and adds it to your project: +{ + "name": "my-astro-site", + "compatibility_date": "2025-09-09", + "assets": { + "directory": "dist" + } +} + +# Next time you run wrangler deploy, this will use the configuration in your newly generated wrangler.jsonc file +wrangler deploy +``` + +## Requirements + +- You must use Wrangler version 4.24.4 or later in order to use this feature +