Configuration
Webflow Cloud is designed to handle most of your deployment configuration, so you can focus on building your app. This page explains what’s configured automatically and what you need to know if you want to understand or troubleshoot the process.
For step-by-step setup use the following guides:
Get started with Webflow Cloud by following our step-by-step guide.
Migrate an existing project to Webflow Cloud.
Deployment details
Webflow Cloud runs your app on Cloudflare Workers.
When you deploy your environment, Webflow Cloud uses Wrangler, Cloudflare’s official command-line tool, to deploy your app to the Workers platform using a default configuration.
Since the Workers runtime differs from the standard Node.js environment, some frameworks may require additional setup—such as framework-specific adapters or configuration files—to function properly. The required configurations for supported frameworks are outlined below.
Default configuration
When you deploy an environment in Webflow Cloud, Webflow automatically sets up the necessary configuration for deployment to the Workers platform.
wrangler.json
On deployment, Webflow Cloud generates a wrangler.json
file based on the framework specified in your webflow.json
. This file includes recommended defaults for:
- Asset handling
- Node.js API compatibility
- Observability (for example, logging and metrics)
Webflow Cloud will generate a default configuration when you deploy your app. This production file is generated automatically and can’t be edited directly.
Storage resources
Webflow Cloud supports adding storage resources to your environment. by declaring bindings in your wrangler.json
file. Webflow Cloud will read these bindings and create the necessary resources for your app. All other configuration options remain automatically managed by Webflow Cloud and can’t be edited directly.
Next.js
Astro
For more details on Wrangler configuration, see the Wrangler documentation.
Framework-specific files
Some frameworks require additional configuration to run on the Workers runtime (such as Cloudflare adapters or runtime-specific settings). Webflow Cloud handles this differently depending on how your project was created:
-
New projects using the Webflow Cloud CLI
The CLI scaffolds any necessary files automatically when you create a new project. -
Existing projects (bring your own app)
Follow the bring your own app guide to ensure all required files are present in your project.
Next.js
Astro
Next.js apps require the following files:
cloudflare.env.ts
: Enables your app to access your environment variables..open-next.config.ts
: Enables Next.js to run on the edge runtime.next.config.js
: Ensures your app uses your environment’s mount path and the Cloudflare adapter.
Troubleshooting and common questions
Why can’t I edit wrangler.json
?
Why can’t I edit wrangler.json
?
Webflow Cloud manages this file to ensure compatibility and security.
How do I migrate an existing project?
If you’re migrating an existing project, follow the steps in the Bring your own app guide.