Upgrade the Cloudflare Vite Plugin.

Co-authored-by: David Gustys <me@davidgustys.com>

Author: cpojer

.gitignore

@@ -5,6 +5,7 @@ dist
 *.tsbuildinfo
 .DS_Store
 .wrangler
+.cloudflare
 .void-wrangler.jsonc
 .env
 .claude

README.md

@@ -12,7 +12,7 @@ The SDK's features are optional and composable. Use React, Vue, Svelte, or Solid
 
 ## Getting Started
 
-Use Node.js 24.21.0 or later. In an empty directory, run:
+Use Node.js 24.22+ or 26.12+. In an empty directory, run:
 
 ```sh
 npm install -D void

docs/guide/platform/installation/prerequisites.md

@@ -37,7 +37,7 @@ If your account's dashboard has no **Enable** action, create a disposable Hello
 
 ## Install the CLI and Preview
 
-With Node.js 24.21.0 or later, install the CLI:
+With Node.js 24.22+ or 26.12+, install the CLI:
 
 ```sh
 pnpm add --global void

docs/reference/api/plugin.md

@@ -16,10 +16,10 @@ export default defineConfig({
 });
 ```
 
-| Option             | Type                      | Description                                                                                                                                                                                                                       |
-| ------------------ | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `persistTo`        | `string`                  | Directory path for persisting local dev state (D1, KV, R2). Defaults to `.void/` in the project root.                                                                                                                             |
-| `auxiliaryWorkers` | `AuxiliaryWorkerConfig[]` | Additional workers to run inside the same Miniflare instance during dev. Passed through to `@cloudflare/vite-plugin`. Useful for running multiple workers that share bindings (e.g. a separate API worker alongside a dashboard). |
+| Option             | Type                      | Description                                                                                                                                                                                                                                 |
+| ------------------ | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `persistTo`        | `string`                  | Directory path for persisting local dev state (D1, KV, R2). Defaults to `.void/` in the project root.                                                                                                                                       |
+| `auxiliaryWorkers` | `AuxiliaryWorkerConfig[]` | Additional Workers to run alongside your app, such as a separate API Worker and dashboard that share bindings. Each entry accepts `configPath` (JSON, JSONC, or TOML), `config` (settings or a callback), `viteEnvironment`, and `devOnly`. |
 
 ## Project configuration {#project-configuration}
 

docs/reference/cli.md

@@ -76,7 +76,7 @@ Use this page as a command reference. If you are setting up a project for the fi
 | `void email alias [name]`         | Show the shared mail address, or give it a shorter permanent name             |
 | `void email domain`               | Send and receive at your own domain on a Cloudflare zone                      |
 | `void init`                       | Set up a new or existing project, including coding agents                     |
-| `void migrate`                    | Convert legacy `void.json` and root Wrangler JSON/JSONC into `void.config.ts` |
+| `void migrate`                    | Update project configuration                                                  |
 
 ## Binary Invocation {#binary-invocation}
 

docs/reference/cli/setup.md

@@ -23,7 +23,7 @@ Resources recorded in `void.lock.json` without a matching definition appear sepa
 
 `void migrate` converts legacy `void.json` and root `wrangler.jsonc` or `wrangler.json` files into `void.config.ts`. It also accepts one root `wrangler*.json(c)` file referenced by a supported framework adapter. Void saves backups in `.void/config-migration/`, records resource IDs in `void.lock.json`, and updates supported adapters to use its generated Cloudflare config.
 
-`.void-wrangler.jsonc` is generated for Cloudflare tooling and belongs in `.gitignore`; migration adds the entry. Review and commit `void.config.ts`, `void.lock.json`, and `.gitignore`. `void init` and `void deploy` migrate legacy files automatically. If the project has conflicting or multiple Cloudflare configs, resolve them first. The project's installed `void` package must match the CLI version before Cloudflare deployment.
+`void migrate` also adds `.cloudflare` to `.gitignore`, including in projects that already use `void.config.ts`. Configuration migration adds `.void-wrangler.jsonc` to `.gitignore` as well. Review and commit `void.config.ts`, `void.lock.json`, and `.gitignore`. `void init` and `void deploy` migrate legacy files automatically. If the project has conflicting or multiple Cloudflare configs, resolve them first. The project's installed `void` package must match the CLI version before Cloudflare deployment.
 
 ## `void init` {#void-init}
 

packages/create-void/README.md

@@ -4,7 +4,7 @@ Create a full-stack Vite app with [Void](https://void.cloud), ready for local de
 
 ## Getting Started
 
-Use Node.js 24.21.0 or later:
+Use Node.js 24.22+ or 26.12+:
 
 ```sh
 npm create void@latest my-app

packages/create-void/package.json

@@ -35,6 +35,6 @@
     "vite-plus": "catalog:"
   },
   "engines": {
-    "node": ">=24.21.0"
+    "node": "^24.22.0 || >=26.12.0"
   }
 }

packages/deploy-cloudflare/src/diagnostics.ts

@@ -3,8 +3,26 @@ import type { CloudflareCommandResult } from './execute.ts';
 
 const MAX_DIAGNOSTIC_LENGTH = 4096;
 const MAX_DIAGNOSTIC_LINES = 24;
+const ERROR_BOX =
+  /(?:^|\n)[ \t]*┌[ \t]*(?:APIError|Error)\b[^\n]*\n(?:[ \t]*│[^\n]*\n)*[ \t]*└[^\n]*/i;
+// cf draws upload progress, binding tables, config diffs and upload conflicts as log
+// lines: a guide symbol, or its fallback for terminals without Unicode, then two spaces.
+// These lines can show binding values. cf printed them on stdout before 1.0.0-beta.21,
+// and on stderr since.
+const LOG_LINE = /^[├│◆◇●▲■└|*o•!x—](?: {2}|$)/;
+const UPLOAD_CONFLICT =
+  /^[ \t]*(?:\S[ \t]+)?(Aborting the upload operation because of conflicts\..*)$/m;
+const SCRIPT_API_ORIGIN =
+  /^[ \t]*(?:\S[ \t]+)?(You are about to upload a Worker that was last updated via the script API\.)/m;
 
-/** Keep the uploader's error, excluding stdout binding tables and redacting common credential formats. */
+function withoutLogLines(output: string): string {
+  return output
+    .split('\n')
+    .filter((line) => !LOG_LINE.test(line))
+    .join('\n');
+}
+
+/** Keep the uploader's error, excluding cf's log lines and redacting common credential formats. */
 export function cloudflareCommandDiagnostic(result: CloudflareCommandResult): string | undefined {
   const stderr = stripVTControlCharacters(result.stderr).replace(/\r\n?/g, '\n');
   const stdout = stripVTControlCharacters(result.stdout).replace(/\r\n?/g, '\n');
@@ -17,29 +35,28 @@ export function cloudflareCommandDiagnostic(result: CloudflareCommandResult): st
     }
   }
   if (message === stderr && !/(?:^|\n)[ \t]*(?:[✘×X][ \t]+)?\[ERROR\]/i.test(stderr)) {
-    // cf renders API failures as a box on stdout while config warnings go to
-    // stderr. Only copy the error box; stdout may also contain binding values.
-    const box =
-      /(?:^|\n)[ \t]*┌[ \t]*(?:APIError|Error)\b[^\n]*\n(?:[ \t]*│[^\n]*\n)*[ \t]*└[^\n]*/i.exec(
-        stdout,
-      );
+    // Copy only an error box on stdout, the upload conflict without the config diff
+    // that explains it, or stderr without cf's log lines.
+    const box = ERROR_BOX.exec(stdout);
+    const conflict = UPLOAD_CONFLICT.exec(`${stdout}\n${stderr}`);
     if (box) {
       message = box[0].trim();
+    } else if (conflict) {
+      message = [SCRIPT_API_ORIGIN.exec(`${stdout}\n${stderr}`)?.[1], conflict[1]]
+        .filter(Boolean)
+        .join('\n');
     } else {
-      const lines = stdout.split('\n');
-      const abort = lines.find((line) =>
-        line.startsWith('■  Aborting the upload operation because of conflicts.'),
-      );
-      if (abort) {
-        const reason = 'You are about to upload a Worker that was last updated via the script API.';
-        message = [lines.includes(`▲  ${reason}`) ? reason : '', abort.slice('■  '.length)]
-          .filter(Boolean)
-          .join('\n');
-      }
+      // Keep an error box on stderr whole: its bars look like log lines.
+      const stderrBox = ERROR_BOX.exec(stderr);
+      message = stderrBox
+        ? withoutLogLines(stderr.slice(0, stderrBox.index)) +
+          stderrBox[0] +
+          withoutLogLines(stderr.slice(stderrBox.index + stderrBox[0].length))
+        : withoutLogLines(stderr);
     }
   }
-  // Upload progress and bindings are printed on stdout. Never echo that whole stream
-  // when no error block was found, even when the process failed without stderr.
+  // Never echo stdout, or cf's log lines on stderr, when no error block was found,
+  // even when the process failed without stderr.
   message = stripVTControlCharacters(message)
     .split(/\n\s*(?:🪵|Logs (?:were )?written|If you think this is a bug)/)[0]!
     .trim();

packages/deploy-cloudflare/test/unit/diagnostics.test.ts

@@ -53,6 +53,92 @@ describe('Cloudflare command diagnostics', () => {
     ).toBe('┌ APIError\n│ [10000] Worker upload failed.\n└');
   });
 
+  it('keeps an error box and its advice on stderr without the binding table before it', () => {
+    expect(
+      cloudflareCommandDiagnostic({
+        status: 1,
+        stdout: '',
+        // cf 1.0.0-beta.21 and later print upload progress and bindings on stderr.
+        stderr: [
+          '├  Upload',
+          '│  Your Worker has access to the following bindings:',
+          '│  Binding                               Resource',
+          '│  env.PRIVATE_VALUE ("do-not-echo")     Environment Variable',
+          '|  env.ASCII_VALUE ("do-not-echo")       Environment Variable',
+          '│',
+          '',
+          '┌ APIError',
+          '│ [10000] Authentication error [code: 10000]',
+          '│',
+          '│ 403 Forbidden',
+          '└',
+          '',
+          '→ Check your API token permissions',
+        ].join('\n'),
+      }),
+    ).toBe(
+      '┌ APIError\n│ [10000] Authentication error [code: 10000]\n│\n│ 403 Forbidden\n└\n\n→ Check your API token permissions',
+    );
+    expect(
+      cloudflareCommandDiagnostic({
+        status: 1,
+        stdout: '',
+        stderr: '├  Upload\n│  env.PRIVATE_VALUE ("do-not-echo")\nUpload stopped.',
+      }),
+    ).toBe('Upload stopped.');
+    expect(
+      cloudflareCommandDiagnostic({
+        status: 1,
+        stdout: '',
+        stderr: '├  Upload\n│  env.PRIVATE_VALUE ("do-not-echo")\n◆  Version upload complete',
+      }),
+    ).toBeUndefined();
+  });
+
+  it('reports upload conflicts from either stream without the config diff', () => {
+    const abort =
+      'Aborting the upload operation because of conflicts. To override and upload anyway, remove the `--strict` flag';
+    const reason = 'You are about to upload a Worker that was last updated via the script API.';
+    const scriptApi = [
+      '├  Upload',
+      `▲  ${reason}`,
+      '│  Edits that have been made via the script API will be overridden by your local code and config.',
+      `■  ${abort}`,
+      '◆  Version upload complete',
+    ].join('\n');
+    // cf 1.0.0-beta.21 and later print upload messages on stderr, earlier releases on stdout.
+    for (const [stdout, stderr] of [
+      ['', scriptApi],
+      [scriptApi, ''],
+      // Without a Unicode terminal, cf prints fallback symbols.
+      ['', scriptApi.replace('▲', '!').replace('■', 'x').replace('│', '|').replace('◆', '*')],
+    ]) {
+      expect(cloudflareCommandDiagnostic({ status: 1, stdout: stdout!, stderr: stderr! })).toBe(
+        `${reason}\n${abort}`,
+      );
+    }
+    expect(
+      cloudflareCommandDiagnostic({
+        status: 1,
+        stdout: '',
+        stderr: [
+          '├  Upload',
+          '▲  The local configuration being used (generated from your local configuration file) differs from the remote configuration of your Worker set via the Cloudflare Dashboard:',
+          '│   {',
+          '│     vars: {',
+          '│  -    REMOTE_VALUE: "do-not-echo"',
+          `│  +    LOCAL_VALUE: "${abort} do-not-echo"`,
+          '│     }',
+          '│   }',
+          '│',
+          '│  Uploading the Worker will override the remote configuration with your local one.',
+          `■  ${abort}`,
+          '◆  Version upload complete',
+        ].join('\n'),
+      }),
+    ).toBe(abort);
+  });
+
   it('retains plain stderr and process-spawn failures', () => {
     expect(
       cloudflareCommandDiagnostic({ status: 1, stdout: '', stderr: 'Unknown argument: strict' }),