From b208c65cce4788027fb61584f667c9d0895e7031 Mon Sep 17 00:00:00 2001 From: Brendan Irvine-Broque Date: Thu, 29 Oct 2026 16:12:32 -0700 Subject: [PATCH 1/2] [Workers, Cloudflare CLI] Make Vite+ docs discoverable --- .../docs/cf/get-started/first-worker.mdx | 2 +- .../docs/workers/vite-plugin/index.mdx | 4 ++- .../docs/workers/vite-plugin/vite-plus.mdx | 25 +++++++++++++++++++ 3 files changed, 29 insertions(+), 2 deletions(-) create mode 100644 src/content/docs/workers/vite-plugin/vite-plus.mdx diff --git a/src/content/docs/cf/get-started/first-worker.mdx b/src/content/docs/cf/get-started/first-worker.mdx index 50d2506b363..6645d85e178 100644 --- a/src/content/docs/cf/get-started/first-worker.mdx +++ b/src/content/docs/cf/get-started/first-worker.mdx @@ -1,6 +1,6 @@ --- title: Deploy your first Worker -description: Create a Workers project with cf init, develop it locally, and deploy it with the Cloudflare CLI. +description: Create a Vite+ Workers project with cf init, develop it locally, and deploy it with the Cloudflare CLI. pcx_content_type: get-started sidebar: order: 2 diff --git a/src/content/docs/workers/vite-plugin/index.mdx b/src/content/docs/workers/vite-plugin/index.mdx index d7482b45a44..a48ce600943 100644 --- a/src/content/docs/workers/vite-plugin/index.mdx +++ b/src/content/docs/workers/vite-plugin/index.mdx @@ -3,7 +3,7 @@ pcx_content_type: overview title: Vite plugin sidebar: order: 17 -description: A full-featured integration between Vite and the Workers runtime +description: Integrate Vite and Vite+ with the Workers runtime using the Cloudflare Vite plugin. products: - workers --- @@ -13,6 +13,8 @@ import { Render } from "~/components"; The Cloudflare Vite plugin enables a full-featured integration between [Vite](https://vite.dev/) and the [Workers runtime](/workers/runtime-apis/). Your Worker code runs inside a local [`workerd`](https://github.com/cloudflare/workerd) process, which closely matches the runtime APIs and behavior of deployed Workers. +For new Workers and supported Vite-based apps, use [Vite+ on Workers](/workers/vite-plugin/vite-plus/) for development, builds, formatting, linting, type checking, and testing. + ## Features diff --git a/src/content/docs/workers/vite-plugin/vite-plus.mdx b/src/content/docs/workers/vite-plugin/vite-plus.mdx new file mode 100644 index 00000000000..791ea691ead --- /dev/null +++ b/src/content/docs/workers/vite-plugin/vite-plus.mdx @@ -0,0 +1,25 @@ +--- +title: Vite+ on Workers +description: Use Vite+ with the Cloudflare Vite plugin for new Workers and Vite-based apps, or adopt it in an existing project. +pcx_content_type: integration-guide +sidebar: + order: 3 +products: + - workers +--- + +[Vite+](https://viteplus.dev/) combines Vite with formatting, linting, type checking, and testing. Use Vite+ with the [Cloudflare Vite plugin](/workers/vite-plugin/) for new Workers and supported Vite-based apps. + +The plugin runs your Worker code in the Workers runtime during development. Vite+ provides the project toolchain through the `vp` command. + +## Start a new project + +To create a standalone Worker with `cf init`, follow [Deploy your first Worker](/cf/get-started/first-worker/). Use the generated Vite+ scripts for checks, formatting, and tests alongside `cf dev`, `cf build`, and `cf deploy`. + +For a framework application, start with the appropriate [framework guide](/workers/framework-guides/). Preserve framework-specific build steps when adopting Vite+. + +## Adopt Vite+ in an existing project + +Follow the [Vite+ migration guide](https://viteplus.dev/guide/migrate) for requirements and migration steps. If your project does not yet use the Cloudflare Vite plugin, follow the [plugin setup guide](/workers/vite-plugin/get-started/). + +Keep your framework scripts and Cloudflare deployment command. Adopting Vite+ does not require changing your Cloudflare configuration format. Preserve existing toolchains during unrelated changes. From 9e988aa64d228077d3c26e72378f8989115e4d27 Mon Sep 17 00:00:00 2001 From: Brendan Irvine-Broque Date: Thu, 29 Oct 2026 16:33:27 -0700 Subject: [PATCH 2/2] Apply batched suggestions from code review Co-authored-by: Brendan Irvine-Broque --- src/content/docs/cf/get-started/first-worker.mdx | 2 +- src/content/docs/workers/vite-plugin/index.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/src/content/docs/cf/get-started/first-worker.mdx b/src/content/docs/cf/get-started/first-worker.mdx index 6645d85e178..50d2506b363 100644 --- a/src/content/docs/cf/get-started/first-worker.mdx +++ b/src/content/docs/cf/get-started/first-worker.mdx @@ -1,6 +1,6 @@ --- title: Deploy your first Worker -description: Create a Vite+ Workers project with cf init, develop it locally, and deploy it with the Cloudflare CLI. +description: Create a Workers project with cf init, develop it locally, and deploy it with the Cloudflare CLI. pcx_content_type: get-started sidebar: order: 2 diff --git a/src/content/docs/workers/vite-plugin/index.mdx b/src/content/docs/workers/vite-plugin/index.mdx index a48ce600943..2c8775252ba 100644 --- a/src/content/docs/workers/vite-plugin/index.mdx +++ b/src/content/docs/workers/vite-plugin/index.mdx @@ -13,7 +13,7 @@ import { Render } from "~/components"; The Cloudflare Vite plugin enables a full-featured integration between [Vite](https://vite.dev/) and the [Workers runtime](/workers/runtime-apis/). Your Worker code runs inside a local [`workerd`](https://github.com/cloudflare/workerd) process, which closely matches the runtime APIs and behavior of deployed Workers. -For new Workers and supported Vite-based apps, use [Vite+ on Workers](/workers/vite-plugin/vite-plus/) for development, builds, formatting, linting, type checking, and testing. +For new Workers and supported Vite-based apps, use [Vite+](/workers/vite-plugin/vite-plus/) for development, builds, formatting, linting, type checking, and testing.