v2 beta

Vite plugin v2 uses cloudflare.config.ts for configuration and integrates with the cf CLI for deployment.

See Deploy your first Worker to quickly scaffold a new project using the beta.

Alternatively, to try the beta in an existing project, install the Vite plugin and cf as development dependencies.

npm i -D @cloudflare/vite-plugin@beta cf

yarn add -D @cloudflare/vite-plugin@beta cf

pnpm add -D @cloudflare/vite-plugin@beta cf

bun add -d @cloudflare/vite-plugin@beta cf

The following table summarizes the main differences:

v2 reads configuration from cloudflare.config.ts. It does not load Wrangler configuration files. To convert an existing configuration, refer to Migrate from Wrangler to cf.

The configPath option has been removed and the config, auxiliaryWorkers, and prerenderWorker options now accept the new camelCase Worker configuration format.

vite build always writes structured Build Output to .cloudflare/output. Run cf deploy to build and deploy. To deploy an existing build without rebuilding, use cf deploy --prebuilt

Wrangler cannot deploy applications built with Vite plugin v2. Wrangler is also no longer a runtime or peer dependency of the plugin.

When a project configures Containers, vite build builds Dockerfile-backed Container images and records them in the Build Output. vite preview reuses these images instead of rebuilding them.

The entry Worker now uses the ssr Vite environment by default. Update Vite configuration and plugins that target the previous Worker-derived name to use environments.ssr. To keep the previous name, set viteEnvironment.name explicitly in the cloudflare() plugin options.

v2 generates .cloudflare/types/index.d.ts during development and builds. The declarations infer bindings from cloudflare.config.ts. They also include runtime types for the configured compatibility date and compatibility flags.

Add the configuration file and generated declarations to your TypeScript configuration:

{
	"include": ["src", "cloudflare.config.ts", ".cloudflare/types"]
}

Use the top-level types plugin option to turn off generation or omit runtime types. For the equivalent manual command, refer to Generate types.

v2 uses Vite's resolved mode and envDir to locate .dev.vars and .env files that provide declared Worker secrets. Use Vite's --mode option instead of CLOUDFLARE_ENV to select mode-specific files. When --mode is not specified, the mode defaults to development in dev and production in build.

For preview, set the mode during vite build. vite preview uses the mode recorded in the Build Output.

v2 also removes the deprecated WRANGLER_HYPERDRIVE_LOCAL_CONNECTION_STRING_<BINDING_NAME> environment variable. Rename Hyperdrive local overrides to CLOUDFLARE_HYPERDRIVE_LOCAL_CONNECTION_STRING_<BINDING_NAME>.

v2 no longer rewrites legacy local testing endpoints. Update scripts, tests, and integrations that call these endpoints directly: